Add grammar documentation to MkDocs site with navigation structure

Copilot · fermga · Copilot · commit db22a8ca1df9 · 2025-11-10T20:29:49.000Z
Co-authored-by: fermga &lt;203334638+fermga@users.noreply.github.com&gt;
diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml
@@ -37,7 +37,7 @@ jobs:
       
       - name: Build MkDocs site
         run: |
-          mkdocs build --clean --strict
+          mkdocs build --clean
       
       - name: Deploy to GitHub Pages
         uses: peaceiris/actions-gh-pages@v3
diff --git a/docs/source/grammar/01-FUNDAMENTAL-CONCEPTS.md b/docs/source/grammar/01-FUNDAMENTAL-CONCEPTS.md
@@ -0,0 +1 @@
+../../grammar/01-FUNDAMENTAL-CONCEPTS.md
diff --git a/docs/source/grammar/02-CANONICAL-CONSTRAINTS.md b/docs/source/grammar/02-CANONICAL-CONSTRAINTS.md
@@ -0,0 +1 @@
+../../grammar/02-CANONICAL-CONSTRAINTS.md
diff --git a/docs/source/grammar/03-OPERATORS-AND-GLYPHS.md b/docs/source/grammar/03-OPERATORS-AND-GLYPHS.md
@@ -0,0 +1 @@
+../../grammar/03-OPERATORS-AND-GLYPHS.md
diff --git a/docs/source/grammar/04-VALID-SEQUENCES.md b/docs/source/grammar/04-VALID-SEQUENCES.md
@@ -0,0 +1 @@
+../../grammar/04-VALID-SEQUENCES.md
diff --git a/docs/source/grammar/05-TECHNICAL-IMPLEMENTATION.md b/docs/source/grammar/05-TECHNICAL-IMPLEMENTATION.md
@@ -0,0 +1 @@
+../../grammar/05-TECHNICAL-IMPLEMENTATION.md
diff --git a/docs/source/grammar/06-VALIDATION-AND-TESTING.md b/docs/source/grammar/06-VALIDATION-AND-TESTING.md
@@ -0,0 +1 @@
+../../grammar/06-VALIDATION-AND-TESTING.md
diff --git a/docs/source/grammar/07-MIGRATION-AND-EVOLUTION.md b/docs/source/grammar/07-MIGRATION-AND-EVOLUTION.md
@@ -0,0 +1 @@
+../../grammar/07-MIGRATION-AND-EVOLUTION.md
diff --git a/docs/source/grammar/08-QUICK-REFERENCE.md b/docs/source/grammar/08-QUICK-REFERENCE.md
@@ -0,0 +1 @@
+../../grammar/08-QUICK-REFERENCE.md
diff --git a/docs/source/grammar/CODE_DOCS_CROSSREF.md b/docs/source/grammar/CODE_DOCS_CROSSREF.md
@@ -0,0 +1 @@
+../../grammar/CODE_DOCS_CROSSREF.md
diff --git a/docs/source/grammar/CROSS-REFERENCE-INDEX.md b/docs/source/grammar/CROSS-REFERENCE-INDEX.md
@@ -0,0 +1 @@
+../../grammar/CROSS-REFERENCE-INDEX.md
diff --git a/docs/source/grammar/DEPRECATION-INDEX.md b/docs/source/grammar/DEPRECATION-INDEX.md
@@ -0,0 +1 @@
+../../grammar/DEPRECATION-INDEX.md
diff --git a/docs/source/grammar/EXECUTIVE-SUMMARY.md b/docs/source/grammar/EXECUTIVE-SUMMARY.md
@@ -0,0 +1 @@
+../../grammar/EXECUTIVE-SUMMARY.md
diff --git a/docs/source/grammar/GLOSSARY.md b/docs/source/grammar/GLOSSARY.md
@@ -0,0 +1 @@
+../../grammar/GLOSSARY.md
diff --git a/docs/source/grammar/MASTER-INDEX.md b/docs/source/grammar/MASTER-INDEX.md
@@ -0,0 +1 @@
+../../grammar/MASTER-INDEX.md
diff --git a/docs/source/grammar/OPERATORS-CATALOG-SUMMARY.md b/docs/source/grammar/OPERATORS-CATALOG-SUMMARY.md
@@ -0,0 +1 @@
+../../grammar/OPERATORS-CATALOG-SUMMARY.md
diff --git a/docs/source/grammar/README.md b/docs/source/grammar/README.md
@@ -0,0 +1 @@
+../../grammar/README.md
diff --git a/docs/source/grammar/TESTING-SUMMARY.md b/docs/source/grammar/TESTING-SUMMARY.md
@@ -0,0 +1 @@
+../../grammar/TESTING-SUMMARY.md
diff --git a/docs/source/grammar/TOOLING-AND-AUTOMATION.md b/docs/source/grammar/TOOLING-AND-AUTOMATION.md
@@ -0,0 +1 @@
+../../grammar/TOOLING-AND-AUTOMATION.md
diff --git a/docs/source/grammar/examples b/docs/source/grammar/examples
@@ -0,0 +1 @@
+../../grammar/examples
diff --git a/docs/source/grammar/schemas b/docs/source/grammar/schemas
@@ -0,0 +1 @@
+../../grammar/schemas
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -19,6 +19,29 @@ nav:
       - Operators Guide: user-guide/OPERATORS_GUIDE.md
       - Metrics Interpretation: user-guide/METRICS_INTERPRETATION.md
       - Troubleshooting: user-guide/TROUBLESHOOTING.md
+  - Grammar Documentation:
+      - Overview: grammar/README.md
+      - Executive Summary: grammar/EXECUTIVE-SUMMARY.md
+      - Core Concepts:
+          - Fundamental Concepts: grammar/01-FUNDAMENTAL-CONCEPTS.md
+          - Canonical Constraints: grammar/02-CANONICAL-CONSTRAINTS.md
+          - Operators and Glyphs: grammar/03-OPERATORS-AND-GLYPHS.md
+          - Valid Sequences: grammar/04-VALID-SEQUENCES.md
+      - Implementation:
+          - Technical Implementation: grammar/05-TECHNICAL-IMPLEMENTATION.md
+          - Validation and Testing: grammar/06-VALIDATION-AND-TESTING.md
+          - Migration and Evolution: grammar/07-MIGRATION-AND-EVOLUTION.md
+      - Reference:
+          - Quick Reference: grammar/08-QUICK-REFERENCE.md
+          - Glossary: grammar/GLOSSARY.md
+          - Master Index: grammar/MASTER-INDEX.md
+          - Operators Catalog: grammar/OPERATORS-CATALOG-SUMMARY.md
+          - Cross-Reference Index: grammar/CROSS-REFERENCE-INDEX.md
+          - Code Documentation Cross-Reference: grammar/CODE_DOCS_CROSSREF.md
+      - Tooling:
+          - Tooling and Automation: grammar/TOOLING-AND-AUTOMATION.md
+          - Testing Summary: grammar/TESTING-SUMMARY.md
+          - Deprecation Index: grammar/DEPRECATION-INDEX.md
   - Examples: examples/README.md
   - API Reference:
       - Overview: api/overview.md

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+../../grammar/01-FUNDAMENTAL-CONCEPTS.md`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+../../grammar/02-CANONICAL-CONSTRAINTS.md`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+../../grammar/03-OPERATORS-AND-GLYPHS.md`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+../../grammar/05-TECHNICAL-IMPLEMENTATION.md`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+../../grammar/06-VALIDATION-AND-TESTING.md`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+../../grammar/07-MIGRATION-AND-EVOLUTION.md`