status-im · jorge-campo · Sep 30, 2025 · Sep 30, 2025 · Oct 1, 2025
diff --git a/docs-standards/00-quickstart.md → docs/README.md b/docs-standards/00-quickstart.md → docs/README.md
diff --git a/docs-standards/01-general-guidelines.md → docs/codex/README.md b/docs-standards/01-general-guidelines.md → docs/codex/README.md
diff --git a/...ntent/01-document-types/api-quickstart.md → docs/nomos/README.md b/...ntent/01-document-types/api-quickstart.md → docs/nomos/README.md
diff --git a/...content/01-document-types/hybrid-topic.md → docs/waku/README.md b/...content/01-document-types/hybrid-topic.md → docs/waku/README.md
diff --git a/...tent/01-document-types/troubleshooting.md → manual/0-overview/README.md b/...tent/01-document-types/troubleshooting.md → manual/0-overview/README.md
diff --git a/...ndards/10-structure-the-content/_index.md → manual/1-design-the-information/README.md b/...ndards/10-structure-the-content/_index.md → manual/1-design-the-information/README.md
diff --git a/...tandards/20-style-the-content/01-voice.md → ...ormation/document-types/api-quickstart.md b/...tandards/20-style-the-content/01-voice.md → ...ormation/document-types/api-quickstart.md
diff --git a/...nt-types/concept-help-me-to-understand.md → ...nt-types/concept-help-me-to-understand.md b/...nt-types/concept-help-me-to-understand.md → ...nt-types/concept-help-me-to-understand.md
diff --git a/...20-style-the-content/02-capitalization.md → ...nformation/document-types/hybrid-topic.md b/...20-style-the-content/02-capitalization.md → ...nformation/document-types/hybrid-topic.md
diff --git a/...document-types/procedure-help-me-to-do.md → ...document-types/procedure-help-me-to-do.md b/...document-types/procedure-help-me-to-do.md → ...document-types/procedure-help-me-to-do.md
diff --git a/...t-types/quickstart-help-me-get-started.md → ...t-types/quickstart-help-me-get-started.md b/...t-types/quickstart-help-me-get-started.md → ...t-types/quickstart-help-me-get-started.md
diff --git a/...nt-types/reference-help-me-to-remember.md → ...nt-types/reference-help-me-to-remember.md b/...nt-types/reference-help-me-to-remember.md → ...nt-types/reference-help-me-to-remember.md
diff --git a/...andards/20-style-the-content/03-titles.md → ...rmation/document-types/troubleshooting.md b/...andards/20-style-the-content/03-titles.md → ...rmation/document-types/troubleshooting.md
diff --git a/...he-content/04-sentences-and-paragraphs.md → manual/2-populate-the-structure/README.md b/...he-content/04-sentences-and-paragraphs.md → manual/2-populate-the-structure/README.md
diff --git a/examples/concept-example.md → ...ure/canonical-examples/concept-example.md b/examples/concept-example.md → ...ure/canonical-examples/concept-example.md
diff --git a/...the-content/05-punctuation-and-symbols.md → ...al/2-populate-the-structure/llm/README.md b/...the-content/05-punctuation-and-symbols.md → ...al/2-populate-the-structure/llm/README.md
diff --git a/manual/2-populate-the-structure/templates/README.md b/manual/2-populate-the-structure/templates/README.md
@@ -0,0 +1,75 @@
+# Templates
+
+This directory contains templates to create new technical documents for Logos. Templates help maintain consistency and save time when creating similar types of content.
+
+- [Quickstart template](./quickstart-template.md)
+- [Concept template](./concept-template.md)
+- [Procedure template](./procedure-template.md)
+- [Reference template](./reference-template.md)
+
+## Using templates
+
+Templates are Markdown files. To use a template, copy the desired template content and paste it into your new document. Then, fill in the relevant sections with your content.
+
+> **Note:**
+>
+> Your content should follow the structure and guidelines provided in the template. Don't modify the template to fit your content. If you need to update a template, send a pull request with your changes following the [contribution guidelines](../../CONTRIBUTING.md).
+
+## Guided vs. minimal templates
+
+The templates in this section use a guided approach, providing detailed instructions and examples to help you structure your content effectively.
+
+Unlike minimal templates, which offer only basic headings and leave much of the structure up to the author, guided templates are dense with content and may feel overwhelming at first. This initial density is intentional: it makes expectations explicit, prevents omissions, and typically shortens drafting and review time.
+
+The rationale for using guided templates instead of minimal templates is twofold:
+
+1. **Reduce context switching**: Minimize the need for authors to jump between resources (e.g., writing rules and examples) while drafting. Guided templates provide instructions and examples in one place.
+2. **Support inexperienced authors**: SMEs are typically not trained as technical writers. For highly technical content that is not frequently updated, guided templates are the most effective way to help inexperienced authors produce complete and clear documentation.
+This diagram illustrates this situation:
+
+```mermaid
+%%{init: {
+  "theme": "base",
+  "themeVariables": {
+    "fontFamily": "Inter, ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto",
+    "fontSize": "14px",
+    "primaryTextColor": "#0f172a",
+    "lineColor": "#94a3b8"
+  },
+  "flowchart": { "curve": "basis", "nodeSpacing": 50, "rankSpacing": 60 }
+}}%%
+flowchart LR
+  %% Groups
+  subgraph Inputs
+    direction TB
+    A{Doc<br/>complexity?}:::decision
+    B{Writer<br/>experience?}:::decision
+    E{Update<br/>frequency?}:::decision
+  end
+
+  subgraph Recommendation
+    direction TB
+    C([Lightweight<br/>template]):::good
+    D([Feature-rich<br/>template]):::strong
+  end
+
+  %% Flows
+  A -- High --> B
+  A -- Low --> C
+  B -- New --> D
+  B -- Experienced --> C
+  E -- Often --> C
+  E -- Rare --> D
+
+  %% (Optional) layout hint to keep Inputs aligned
+  A -. Align -.-> E
+
+  %% Styles
+  classDef decision fill:#eff6ff,stroke:#3b82f6,stroke-width:1.5px,color:#0f172a;
+  classDef good fill:#ecfdf5,stroke:#10b981,stroke-width:1.5px,color:#064e3b;
+  classDef strong fill:#f5f3ff,stroke:#8b5cf6,stroke-width:1.5px,color:#2e1065;
+
+  %% Link accents (green to "Lightweight", purple to "Feature-rich")
+  linkStyle 1,3,4 stroke:#10b981,stroke-width:1.5px;
+  linkStyle 2,5 stroke:#8b5cf6,stroke-width:1.5px;
+```
diff --git a/templates/concept/concept-template.md → ...e-structure/templates/concept-template.md b/templates/concept/concept-template.md → ...e-structure/templates/concept-template.md
diff --git a/templates/concept/reference-template.md → ...structure/templates/reference-template.md b/templates/concept/reference-template.md → ...structure/templates/reference-template.md
diff --git a/templates/quickstart/template-quickstart.md → ...tructure/templates/template-quickstart.md b/templates/quickstart/template-quickstart.md → ...tructure/templates/template-quickstart.md
diff --git a/...s/20-style-the-content/06-bullet-lists.md → manual/3-validate-the-design/README.md b/...s/20-style-the-content/06-bullet-lists.md → manual/3-validate-the-design/README.md
diff --git a/...20-style-the-content/07-numbered-lists.md → ...l/3-validate-the-design/linters/README.md b/...20-style-the-content/07-numbered-lists.md → ...l/3-validate-the-design/linters/README.md
diff --git a/...andards/20-style-the-content/08-tables.md → ...validate-the-design/self-review/README.md b/...andards/20-style-the-content/08-tables.md → ...validate-the-design/self-review/README.md
diff --git a/...-style-the-content/09-units-of-measure.md → ...-validate-the-design/sme-review/README.md b/...-style-the-content/09-units-of-measure.md → ...-validate-the-design/sme-review/README.md
diff --git a/...tandards/20-style-the-content/10-links.md → ...lidate-the-design/writing-rules/README.md b/...tandards/20-style-the-content/10-links.md → ...lidate-the-design/writing-rules/README.md
diff --git a/...ds/20-style-the-content/11-ui-elements.md → ...ing-rules/structure-the-content/README.md b/...ds/20-style-the-content/11-ui-elements.md → ...ing-rules/structure-the-content/README.md
diff --git a/...ds/20-style-the-content/12-admonitions.md → ...writing-rules/style-the-content/README.md b/...ds/20-style-the-content/12-admonitions.md → ...writing-rules/style-the-content/README.md
diff --git a/...-standards/20-style-the-content/_index.md → ...ng-rules/style-the-content/admonitions.md b/...-standards/20-style-the-content/_index.md → ...ng-rules/style-the-content/admonitions.md
diff --git a/...30-work-with-media/01-icons and emojis.md → ...g-rules/style-the-content/bullet-lists.md b/...30-work-with-media/01-icons and emojis.md → ...g-rules/style-the-content/bullet-lists.md
diff --git a/...standards/30-work-with-media/02-images.md → ...rules/style-the-content/capitalization.md b/...standards/30-work-with-media/02-images.md → ...rules/style-the-content/capitalization.md
diff --git a/...standards/20-style-the-content/13-code.md → ...n/writing-rules/style-the-content/code.md b/...standards/20-style-the-content/13-code.md → ...n/writing-rules/style-the-content/code.md
diff --git a/...andards/30-work-with-media/03-diagrams.md → .../writing-rules/style-the-content/links.md b/...andards/30-work-with-media/03-diagrams.md → .../writing-rules/style-the-content/links.md
diff --git a/...standards/30-work-with-media/04-videos.md → ...rules/style-the-content/numbered-lists.md b/...standards/30-work-with-media/04-videos.md → ...rules/style-the-content/numbered-lists.md
diff --git a/docs-standards/30-work-with-media/_index.md → ...le-the-content/punctuation-and-symbols.md b/docs-standards/30-work-with-media/_index.md → ...le-the-content/punctuation-and-symbols.md
diff --git a/docs-standards/40-terminology/01-common.md → ...e-the-content/sentences-and-paragraphs.md b/docs-standards/40-terminology/01-common.md → ...e-the-content/sentences-and-paragraphs.md
diff --git a/docs-standards/40-terminology/02-waku.md → ...writing-rules/style-the-content/tables.md b/docs-standards/40-terminology/02-waku.md → ...writing-rules/style-the-content/tables.md
diff --git a/docs-standards/40-terminology/03-codex.md → ...writing-rules/style-the-content/titles.md b/docs-standards/40-terminology/03-codex.md → ...writing-rules/style-the-content/titles.md
diff --git a/docs-standards/40-terminology/_index.md → ...ng-rules/style-the-content/ui-elements.md b/docs-standards/40-terminology/_index.md → ...ng-rules/style-the-content/ui-elements.md
diff --git a/manual/3-validate-the-design/writing-rules/style-the-content/units-of-measure.md b/manual/3-validate-the-design/writing-rules/style-the-content/units-of-measure.md
diff --git a/manual/3-validate-the-design/writing-rules/style-the-content/voice.md b/manual/3-validate-the-design/writing-rules/style-the-content/voice.md
diff --git a/manual/3-validate-the-design/writing-rules/terminology/README.md b/manual/3-validate-the-design/writing-rules/terminology/README.md
diff --git a/manual/3-validate-the-design/writing-rules/terminology/codex-terminology.md b/manual/3-validate-the-design/writing-rules/terminology/codex-terminology.md
diff --git a/manual/3-validate-the-design/writing-rules/terminology/common-terminology.md b/manual/3-validate-the-design/writing-rules/terminology/common-terminology.md
diff --git a/manual/3-validate-the-design/writing-rules/terminology/nomos-terminology.md b/manual/3-validate-the-design/writing-rules/terminology/nomos-terminology.md
diff --git a/manual/3-validate-the-design/writing-rules/terminology/waku-terminology.md b/manual/3-validate-the-design/writing-rules/terminology/waku-terminology.md
diff --git a/manual/3-validate-the-design/writing-rules/work-with-media/README.md b/manual/3-validate-the-design/writing-rules/work-with-media/README.md
diff --git a/manual/3-validate-the-design/writing-rules/work-with-media/diagrams.md b/manual/3-validate-the-design/writing-rules/work-with-media/diagrams.md
diff --git a/manual/3-validate-the-design/writing-rules/work-with-media/icons-and-emojis.md b/manual/3-validate-the-design/writing-rules/work-with-media/icons-and-emojis.md
diff --git a/manual/3-validate-the-design/writing-rules/work-with-media/images.md b/manual/3-validate-the-design/writing-rules/work-with-media/images.md
diff --git a/manual/3-validate-the-design/writing-rules/work-with-media/videos.md b/manual/3-validate-the-design/writing-rules/work-with-media/videos.md
diff --git a/manual/4-integrate-the-content/README.md b/manual/4-integrate-the-content/README.md
diff --git a/manual/4-integrate-the-content/build-and-publish/README.md b/manual/4-integrate-the-content/build-and-publish/README.md
diff --git a/manual/4-integrate-the-content/content-model/README.md b/manual/4-integrate-the-content/content-model/README.md
diff --git a/manual/README.md b/manual/README.md
diff --git a/templates/concept/concept-example.md b/templates/concept/concept-example.md