Skip to content
This repository was archived by the owner on Sep 6, 2023. It is now read-only.

Migrate Architecture Doc into Official Arc42 Template#235

Merged
Weltraumschaf merged 27 commits intomainfrom
issue_21
Mar 21, 2022
Merged

Migrate Architecture Doc into Official Arc42 Template#235
Weltraumschaf merged 27 commits intomainfrom
issue_21

Conversation

@Weltraumschaf
Copy link
Member

No description provided.

So it is obvious which files contain content to be migrated into
official Arc42 template structure.

Signed-off-by: Sven Strittmatter <[email protected]>
So we have later a landing page for thearchitecture topic and
we have no nameclash with the Introduction & Goals section from
the Arc42 template.

The content will be migrated into the template section in next
steps.

Signed-off-by: Sven Strittmatter <[email protected]>
@Weltraumschaf Weltraumschaf marked this pull request as draft March 17, 2022 15:02
@Weltraumschaf Weltraumschaf self-assigned this Mar 17, 2022
@netlify
Copy link

netlify bot commented Mar 17, 2022

✅ Deploy Preview for docs-securecodebox-test ready!

🔨 Explore the source changes: d28fe62

🔍 Inspect the deploy log: https://app.netlify.com/sites/docs-securecodebox-test/deploys/62383bbb01ca7400094021f8

😎 Browse the preview: https://deploy-preview-235--docs-securecodebox-test.netlify.app

@Weltraumschaf Weltraumschaf added documentation Improvements or additions to documentation planned Issues we will do in the next sprint. and removed documentation Improvements or additions to documentation planned Issues we will do in the next sprint. labels Mar 17, 2022
We already have a blank template file: 02_architecture_constraints.md

Signed-off-by: Sven Strittmatter <[email protected]>
We already have a blank file for that: 04_solution_strategy.md

Signed-off-by: Sven Strittmatter <[email protected]>
Signed-off-by: Sven Strittmatter <[email protected]>
So we refelct tha same filestructure as in toplevel: blog images
go into img/blog/, docs immages go into img/docs/.

Signed-off-by: Sven Strittmatter <[email protected]>
Signed-off-by: Sven Strittmatter <[email protected]>
Since external URLs are quite long sometimes this increases the
readability drastically.

Signed-off-by: Sven Strittmatter <[email protected]>
We use kebab case almost always, so this is an attempt to align the
file names to be consistent.

Signed-off-by: Sven Strittmatter <[email protected]>
Backticks should only be used to markup things which are code,
executables or file names. To markap things which are a conceptual
name should use emphasize notation (mostly formatted as italic).

Signed-off-by: Sven Strittmatter <[email protected]>
Signed-off-by: Sven Strittmatter <[email protected]>
Since Docusaurus does not support definition lists in Markdow
I use a syntax nearly the same. So, it will be rendered as
definition lists, if they implement this feature in the future.

This format is quite readable and better maintainable than a
table.

Signed-off-by: Sven Strittmatter <[email protected]>
Signed-off-by: Sven Strittmatter <[email protected]>
The diagrams are from some slides we have about SCB. They should be
redrawn with Draw.io, so that they are editable PNGs.

Signed-off-by: Sven Strittmatter <[email protected]>
@Weltraumschaf Weltraumschaf marked this pull request as ready for review March 18, 2022 12:14
@Weltraumschaf Weltraumschaf requested a review from malexmave March 18, 2022 19:46
Copy link
Member

@malexmave malexmave left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few points on the documentation.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

documentation Improvements or additions to documentation planned Issues we will do in the next sprint.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants