From db0e71f8f06ff2ba6fdd4a00a03b586da30fcb00 Mon Sep 17 00:00:00 2001 From: Jorge Campo <62282406+jorge-campo@users.noreply.github.com> Date: Thu, 9 Oct 2025 14:07:34 +0200 Subject: [PATCH] Re-org content in repository (#58) --- docs-standards/00-quickstart.md => docs/README.md | 0 docs-standards/01-general-guidelines.md => docs/codex/README.md | 0 .../01-document-types/api-quickstart.md => docs/nomos/README.md | 0 .../01-document-types/hybrid-topic.md => docs/waku/README.md | 0 .../troubleshooting.md => manual/0-overview/README.md | 0 .../_index.md => manual/1-design-the-information/README.md | 0 .../1-design-the-information/document-types/api-quickstart.md | 0 .../document-types}/concept-help-me-to-understand.md | 0 .../1-design-the-information/document-types/hybrid-topic.md | 0 .../document-types}/procedure-help-me-to-do.md | 0 .../document-types}/quickstart-help-me-get-started.md | 0 .../document-types}/reference-help-me-to-remember.md | 0 .../1-design-the-information/document-types/troubleshooting.md | 0 .../2-populate-the-structure/README.md | 0 .../canonical-examples}/concept-example.md | 0 .../2-populate-the-structure/llm/README.md | 0 .../2-populate-the-structure/templates}/concept-template.md | 0 .../2-populate-the-structure/templates}/reference-template.md | 0 .../2-populate-the-structure/templates}/template-quickstart.md | 0 .../06-bullet-lists.md => manual/3-validate-the-design/README.md | 0 .../3-validate-the-design/linters/README.md | 0 .../3-validate-the-design/self-review/README.md | 0 .../3-validate-the-design/sme-review/README.md | 0 .../3-validate-the-design/writing-rules/README.md | 0 .../writing-rules/structure-the-content/README.md | 0 .../writing-rules/style-the-content/README.md | 0 .../writing-rules/style-the-content/admonitions.md | 0 .../writing-rules/style-the-content/bullet-lists.md | 0 .../writing-rules/style-the-content/capitalization.md | 0 .../writing-rules/style-the-content/code.md | 0 .../writing-rules/style-the-content/links.md | 0 .../writing-rules/style-the-content/numbered-lists.md | 0 .../writing-rules/style-the-content/punctuation-and-symbols.md | 0 .../writing-rules/style-the-content/sentences-and-paragraphs.md | 0 .../writing-rules/style-the-content/tables.md | 0 .../writing-rules/style-the-content/titles.md | 0 .../writing-rules/style-the-content/ui-elements.md | 0 .../writing-rules/style-the-content/units-of-measure.md | 0 .../writing-rules/style-the-content/voice.md | 0 manual/3-validate-the-design/writing-rules/terminology/README.md | 0 .../writing-rules/terminology/codex-terminology.md | 0 .../writing-rules/terminology/common-terminology.md | 0 .../writing-rules/terminology/nomos-terminology.md | 0 .../writing-rules/terminology/waku-terminology.md | 0 .../writing-rules/work-with-media/README.md | 0 .../writing-rules/work-with-media/diagrams.md | 0 .../writing-rules/work-with-media/icons-and-emojis.md | 0 .../writing-rules/work-with-media/images.md | 0 .../writing-rules/work-with-media/videos.md | 0 manual/4-integrate-the-content/README.md | 0 manual/4-integrate-the-content/build-and-publish/README.md | 0 manual/4-integrate-the-content/content-model/README.md | 0 manual/README.md | 0 templates/concept/concept-example.md | 1 - 54 files changed, 1 deletion(-) rename docs-standards/00-quickstart.md => docs/README.md (100%) rename docs-standards/01-general-guidelines.md => docs/codex/README.md (100%) rename docs-standards/10-structure-the-content/01-document-types/api-quickstart.md => docs/nomos/README.md (100%) rename docs-standards/10-structure-the-content/01-document-types/hybrid-topic.md => docs/waku/README.md (100%) rename docs-standards/10-structure-the-content/01-document-types/troubleshooting.md => manual/0-overview/README.md (100%) rename docs-standards/10-structure-the-content/_index.md => manual/1-design-the-information/README.md (100%) rename docs-standards/20-style-the-content/01-voice.md => manual/1-design-the-information/document-types/api-quickstart.md (100%) rename {docs-standards/10-structure-the-content/01-document-types => manual/1-design-the-information/document-types}/concept-help-me-to-understand.md (100%) rename docs-standards/20-style-the-content/02-capitalization.md => manual/1-design-the-information/document-types/hybrid-topic.md (100%) rename {docs-standards/10-structure-the-content/01-document-types => manual/1-design-the-information/document-types}/procedure-help-me-to-do.md (100%) rename {docs-standards/10-structure-the-content/01-document-types => manual/1-design-the-information/document-types}/quickstart-help-me-get-started.md (100%) rename {docs-standards/10-structure-the-content/01-document-types => manual/1-design-the-information/document-types}/reference-help-me-to-remember.md (100%) rename docs-standards/20-style-the-content/03-titles.md => manual/1-design-the-information/document-types/troubleshooting.md (100%) rename docs-standards/20-style-the-content/04-sentences-and-paragraphs.md => manual/2-populate-the-structure/README.md (100%) rename {examples => manual/2-populate-the-structure/canonical-examples}/concept-example.md (100%) rename docs-standards/20-style-the-content/05-punctuation-and-symbols.md => manual/2-populate-the-structure/llm/README.md (100%) rename {templates/concept => manual/2-populate-the-structure/templates}/concept-template.md (100%) rename {templates/concept => manual/2-populate-the-structure/templates}/reference-template.md (100%) rename {templates/quickstart => manual/2-populate-the-structure/templates}/template-quickstart.md (100%) rename docs-standards/20-style-the-content/06-bullet-lists.md => manual/3-validate-the-design/README.md (100%) rename docs-standards/20-style-the-content/07-numbered-lists.md => manual/3-validate-the-design/linters/README.md (100%) rename docs-standards/20-style-the-content/08-tables.md => manual/3-validate-the-design/self-review/README.md (100%) rename docs-standards/20-style-the-content/09-units-of-measure.md => manual/3-validate-the-design/sme-review/README.md (100%) rename docs-standards/20-style-the-content/10-links.md => manual/3-validate-the-design/writing-rules/README.md (100%) rename docs-standards/20-style-the-content/11-ui-elements.md => manual/3-validate-the-design/writing-rules/structure-the-content/README.md (100%) rename docs-standards/20-style-the-content/12-admonitions.md => manual/3-validate-the-design/writing-rules/style-the-content/README.md (100%) rename docs-standards/20-style-the-content/_index.md => manual/3-validate-the-design/writing-rules/style-the-content/admonitions.md (100%) rename docs-standards/30-work-with-media/01-icons and emojis.md => manual/3-validate-the-design/writing-rules/style-the-content/bullet-lists.md (100%) rename docs-standards/30-work-with-media/02-images.md => manual/3-validate-the-design/writing-rules/style-the-content/capitalization.md (100%) rename docs-standards/20-style-the-content/13-code.md => manual/3-validate-the-design/writing-rules/style-the-content/code.md (100%) rename docs-standards/30-work-with-media/03-diagrams.md => manual/3-validate-the-design/writing-rules/style-the-content/links.md (100%) rename docs-standards/30-work-with-media/04-videos.md => manual/3-validate-the-design/writing-rules/style-the-content/numbered-lists.md (100%) rename docs-standards/30-work-with-media/_index.md => manual/3-validate-the-design/writing-rules/style-the-content/punctuation-and-symbols.md (100%) rename docs-standards/40-terminology/01-common.md => manual/3-validate-the-design/writing-rules/style-the-content/sentences-and-paragraphs.md (100%) rename docs-standards/40-terminology/02-waku.md => manual/3-validate-the-design/writing-rules/style-the-content/tables.md (100%) rename docs-standards/40-terminology/03-codex.md => manual/3-validate-the-design/writing-rules/style-the-content/titles.md (100%) rename docs-standards/40-terminology/_index.md => manual/3-validate-the-design/writing-rules/style-the-content/ui-elements.md (100%) create mode 100644 manual/3-validate-the-design/writing-rules/style-the-content/units-of-measure.md create mode 100644 manual/3-validate-the-design/writing-rules/style-the-content/voice.md create mode 100644 manual/3-validate-the-design/writing-rules/terminology/README.md create mode 100644 manual/3-validate-the-design/writing-rules/terminology/codex-terminology.md create mode 100644 manual/3-validate-the-design/writing-rules/terminology/common-terminology.md create mode 100644 manual/3-validate-the-design/writing-rules/terminology/nomos-terminology.md create mode 100644 manual/3-validate-the-design/writing-rules/terminology/waku-terminology.md create mode 100644 manual/3-validate-the-design/writing-rules/work-with-media/README.md create mode 100644 manual/3-validate-the-design/writing-rules/work-with-media/diagrams.md create mode 100644 manual/3-validate-the-design/writing-rules/work-with-media/icons-and-emojis.md create mode 100644 manual/3-validate-the-design/writing-rules/work-with-media/images.md create mode 100644 manual/3-validate-the-design/writing-rules/work-with-media/videos.md create mode 100644 manual/4-integrate-the-content/README.md create mode 100644 manual/4-integrate-the-content/build-and-publish/README.md create mode 100644 manual/4-integrate-the-content/content-model/README.md create mode 100644 manual/README.md delete mode 100644 templates/concept/concept-example.md diff --git a/docs-standards/00-quickstart.md b/docs/README.md similarity index 100% rename from docs-standards/00-quickstart.md rename to docs/README.md diff --git a/docs-standards/01-general-guidelines.md b/docs/codex/README.md similarity index 100% rename from docs-standards/01-general-guidelines.md rename to docs/codex/README.md diff --git a/docs-standards/10-structure-the-content/01-document-types/api-quickstart.md b/docs/nomos/README.md similarity index 100% rename from docs-standards/10-structure-the-content/01-document-types/api-quickstart.md rename to docs/nomos/README.md diff --git a/docs-standards/10-structure-the-content/01-document-types/hybrid-topic.md b/docs/waku/README.md similarity index 100% rename from docs-standards/10-structure-the-content/01-document-types/hybrid-topic.md rename to docs/waku/README.md diff --git a/docs-standards/10-structure-the-content/01-document-types/troubleshooting.md b/manual/0-overview/README.md similarity index 100% rename from docs-standards/10-structure-the-content/01-document-types/troubleshooting.md rename to manual/0-overview/README.md diff --git a/docs-standards/10-structure-the-content/_index.md b/manual/1-design-the-information/README.md similarity index 100% rename from docs-standards/10-structure-the-content/_index.md rename to manual/1-design-the-information/README.md diff --git a/docs-standards/20-style-the-content/01-voice.md b/manual/1-design-the-information/document-types/api-quickstart.md similarity index 100% rename from docs-standards/20-style-the-content/01-voice.md rename to manual/1-design-the-information/document-types/api-quickstart.md diff --git a/docs-standards/10-structure-the-content/01-document-types/concept-help-me-to-understand.md b/manual/1-design-the-information/document-types/concept-help-me-to-understand.md similarity index 100% rename from docs-standards/10-structure-the-content/01-document-types/concept-help-me-to-understand.md rename to manual/1-design-the-information/document-types/concept-help-me-to-understand.md diff --git a/docs-standards/20-style-the-content/02-capitalization.md b/manual/1-design-the-information/document-types/hybrid-topic.md similarity index 100% rename from docs-standards/20-style-the-content/02-capitalization.md rename to manual/1-design-the-information/document-types/hybrid-topic.md diff --git a/docs-standards/10-structure-the-content/01-document-types/procedure-help-me-to-do.md b/manual/1-design-the-information/document-types/procedure-help-me-to-do.md similarity index 100% rename from docs-standards/10-structure-the-content/01-document-types/procedure-help-me-to-do.md rename to manual/1-design-the-information/document-types/procedure-help-me-to-do.md diff --git a/docs-standards/10-structure-the-content/01-document-types/quickstart-help-me-get-started.md b/manual/1-design-the-information/document-types/quickstart-help-me-get-started.md similarity index 100% rename from docs-standards/10-structure-the-content/01-document-types/quickstart-help-me-get-started.md rename to manual/1-design-the-information/document-types/quickstart-help-me-get-started.md diff --git a/docs-standards/10-structure-the-content/01-document-types/reference-help-me-to-remember.md b/manual/1-design-the-information/document-types/reference-help-me-to-remember.md similarity index 100% rename from docs-standards/10-structure-the-content/01-document-types/reference-help-me-to-remember.md rename to manual/1-design-the-information/document-types/reference-help-me-to-remember.md diff --git a/docs-standards/20-style-the-content/03-titles.md b/manual/1-design-the-information/document-types/troubleshooting.md similarity index 100% rename from docs-standards/20-style-the-content/03-titles.md rename to manual/1-design-the-information/document-types/troubleshooting.md diff --git a/docs-standards/20-style-the-content/04-sentences-and-paragraphs.md b/manual/2-populate-the-structure/README.md similarity index 100% rename from docs-standards/20-style-the-content/04-sentences-and-paragraphs.md rename to manual/2-populate-the-structure/README.md diff --git a/examples/concept-example.md b/manual/2-populate-the-structure/canonical-examples/concept-example.md similarity index 100% rename from examples/concept-example.md rename to manual/2-populate-the-structure/canonical-examples/concept-example.md diff --git a/docs-standards/20-style-the-content/05-punctuation-and-symbols.md b/manual/2-populate-the-structure/llm/README.md similarity index 100% rename from docs-standards/20-style-the-content/05-punctuation-and-symbols.md rename to manual/2-populate-the-structure/llm/README.md diff --git a/templates/concept/concept-template.md b/manual/2-populate-the-structure/templates/concept-template.md similarity index 100% rename from templates/concept/concept-template.md rename to manual/2-populate-the-structure/templates/concept-template.md diff --git a/templates/concept/reference-template.md b/manual/2-populate-the-structure/templates/reference-template.md similarity index 100% rename from templates/concept/reference-template.md rename to manual/2-populate-the-structure/templates/reference-template.md diff --git a/templates/quickstart/template-quickstart.md b/manual/2-populate-the-structure/templates/template-quickstart.md similarity index 100% rename from templates/quickstart/template-quickstart.md rename to manual/2-populate-the-structure/templates/template-quickstart.md diff --git a/docs-standards/20-style-the-content/06-bullet-lists.md b/manual/3-validate-the-design/README.md similarity index 100% rename from docs-standards/20-style-the-content/06-bullet-lists.md rename to manual/3-validate-the-design/README.md diff --git a/docs-standards/20-style-the-content/07-numbered-lists.md b/manual/3-validate-the-design/linters/README.md similarity index 100% rename from docs-standards/20-style-the-content/07-numbered-lists.md rename to manual/3-validate-the-design/linters/README.md diff --git a/docs-standards/20-style-the-content/08-tables.md b/manual/3-validate-the-design/self-review/README.md similarity index 100% rename from docs-standards/20-style-the-content/08-tables.md rename to manual/3-validate-the-design/self-review/README.md diff --git a/docs-standards/20-style-the-content/09-units-of-measure.md b/manual/3-validate-the-design/sme-review/README.md similarity index 100% rename from docs-standards/20-style-the-content/09-units-of-measure.md rename to manual/3-validate-the-design/sme-review/README.md diff --git a/docs-standards/20-style-the-content/10-links.md b/manual/3-validate-the-design/writing-rules/README.md similarity index 100% rename from docs-standards/20-style-the-content/10-links.md rename to manual/3-validate-the-design/writing-rules/README.md diff --git a/docs-standards/20-style-the-content/11-ui-elements.md b/manual/3-validate-the-design/writing-rules/structure-the-content/README.md similarity index 100% rename from docs-standards/20-style-the-content/11-ui-elements.md rename to manual/3-validate-the-design/writing-rules/structure-the-content/README.md diff --git a/docs-standards/20-style-the-content/12-admonitions.md b/manual/3-validate-the-design/writing-rules/style-the-content/README.md similarity index 100% rename from docs-standards/20-style-the-content/12-admonitions.md rename to manual/3-validate-the-design/writing-rules/style-the-content/README.md diff --git a/docs-standards/20-style-the-content/_index.md b/manual/3-validate-the-design/writing-rules/style-the-content/admonitions.md similarity index 100% rename from docs-standards/20-style-the-content/_index.md rename to manual/3-validate-the-design/writing-rules/style-the-content/admonitions.md diff --git a/docs-standards/30-work-with-media/01-icons and emojis.md b/manual/3-validate-the-design/writing-rules/style-the-content/bullet-lists.md similarity index 100% rename from docs-standards/30-work-with-media/01-icons and emojis.md rename to manual/3-validate-the-design/writing-rules/style-the-content/bullet-lists.md diff --git a/docs-standards/30-work-with-media/02-images.md b/manual/3-validate-the-design/writing-rules/style-the-content/capitalization.md similarity index 100% rename from docs-standards/30-work-with-media/02-images.md rename to manual/3-validate-the-design/writing-rules/style-the-content/capitalization.md diff --git a/docs-standards/20-style-the-content/13-code.md b/manual/3-validate-the-design/writing-rules/style-the-content/code.md similarity index 100% rename from docs-standards/20-style-the-content/13-code.md rename to manual/3-validate-the-design/writing-rules/style-the-content/code.md diff --git a/docs-standards/30-work-with-media/03-diagrams.md b/manual/3-validate-the-design/writing-rules/style-the-content/links.md similarity index 100% rename from docs-standards/30-work-with-media/03-diagrams.md rename to manual/3-validate-the-design/writing-rules/style-the-content/links.md diff --git a/docs-standards/30-work-with-media/04-videos.md b/manual/3-validate-the-design/writing-rules/style-the-content/numbered-lists.md similarity index 100% rename from docs-standards/30-work-with-media/04-videos.md rename to manual/3-validate-the-design/writing-rules/style-the-content/numbered-lists.md diff --git a/docs-standards/30-work-with-media/_index.md b/manual/3-validate-the-design/writing-rules/style-the-content/punctuation-and-symbols.md similarity index 100% rename from docs-standards/30-work-with-media/_index.md rename to manual/3-validate-the-design/writing-rules/style-the-content/punctuation-and-symbols.md diff --git a/docs-standards/40-terminology/01-common.md b/manual/3-validate-the-design/writing-rules/style-the-content/sentences-and-paragraphs.md similarity index 100% rename from docs-standards/40-terminology/01-common.md rename to manual/3-validate-the-design/writing-rules/style-the-content/sentences-and-paragraphs.md diff --git a/docs-standards/40-terminology/02-waku.md b/manual/3-validate-the-design/writing-rules/style-the-content/tables.md similarity index 100% rename from docs-standards/40-terminology/02-waku.md rename to manual/3-validate-the-design/writing-rules/style-the-content/tables.md diff --git a/docs-standards/40-terminology/03-codex.md b/manual/3-validate-the-design/writing-rules/style-the-content/titles.md similarity index 100% rename from docs-standards/40-terminology/03-codex.md rename to manual/3-validate-the-design/writing-rules/style-the-content/titles.md diff --git a/docs-standards/40-terminology/_index.md b/manual/3-validate-the-design/writing-rules/style-the-content/ui-elements.md similarity index 100% rename from docs-standards/40-terminology/_index.md rename to manual/3-validate-the-design/writing-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 new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b diff --git a/manual/3-validate-the-design/writing-rules/terminology/README.md b/manual/3-validate-the-design/writing-rules/terminology/README.md new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b 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 new file mode 100644 index 00000000..e69de29b diff --git a/manual/4-integrate-the-content/README.md b/manual/4-integrate-the-content/README.md new file mode 100644 index 00000000..e69de29b diff --git a/manual/4-integrate-the-content/build-and-publish/README.md b/manual/4-integrate-the-content/build-and-publish/README.md new file mode 100644 index 00000000..e69de29b diff --git a/manual/4-integrate-the-content/content-model/README.md b/manual/4-integrate-the-content/content-model/README.md new file mode 100644 index 00000000..e69de29b diff --git a/manual/README.md b/manual/README.md new file mode 100644 index 00000000..e69de29b diff --git a/templates/concept/concept-example.md b/templates/concept/concept-example.md deleted file mode 100644 index dcdbcf7a..00000000 --- a/templates/concept/concept-example.md +++ /dev/null @@ -1 +0,0 @@ -# Concept example