diff --git a/documentation/reference-architectures/README.md b/documentation/reference-architectures/README.md index 9bc74c218..59a487ae3 100644 --- a/documentation/reference-architectures/README.md +++ b/documentation/reference-architectures/README.md @@ -1,3 +1,19 @@ # Reference Architectures -Nothing here yet, come back soon... \ No newline at end of file +This page contains sample reference architectures for documentation best practices. Consult the architectures listed here for guidance on implementing specific documentation use cases with recommended tools. + +## Documentation Organization + +Tips for organizing and structuring your documentation artifacts in easy-to-access hierarchies. + +### Multi-System Project + +Use the following hierarchy for organizing your documentation within an organization with self-managed, sub-organizational software systems. This type of hierarchy is particularly common for projects involving logically separated sub-projects and teams that all fall under one overall project umbrella. + +**Preview of architecture** + +[!embed el="embed"](documentation-organization/multi-system-project-markmap.html) + +**Versions:** + +[!button Full Visualization](documentation-organization/multi-system-project.html) [!button Markdown](documentation-organization/multi-system-project-markmap.md) diff --git a/documentation/reference-architectures/documentation-organization/index.yml b/documentation/reference-architectures/documentation-organization/index.yml new file mode 100644 index 000000000..4708564f6 --- /dev/null +++ b/documentation/reference-architectures/documentation-organization/index.yml @@ -0,0 +1 @@ +visibility: hidden \ No newline at end of file diff --git a/documentation/reference-architectures/documentation-organization/multi-system-project-markmap.html b/documentation/reference-architectures/documentation-organization/multi-system-project-markmap.html new file mode 100644 index 000000000..4b982da10 --- /dev/null +++ b/documentation/reference-architectures/documentation-organization/multi-system-project-markmap.html @@ -0,0 +1,40 @@ + + +
+ + + +