Skip to main content

1) Frontend Docs Experience

  • Mintlify-based documentation site with role-oriented navigation in docs.json.
  • Shared component system in snippets/components/.
  • Structural/style enforcement through style-guide tests and hook checks.
  • Route and page index synchronization via operations/scripts/generators/content/catalogs/generate-pages-index.js.
Primary references:
  • v2/resources/documentation-guide/style-guide.mdx
  • v2/resources/documentation-guide/component-library.mdx
  • operations/scripts/generators/content/catalogs/generate-pages-index.js

2) Backend-Like Operational Layer (Docs Ops)

  • Unified CLI entrypoint: lpd.
  • Validation and enforcement scripts across operations/tests/, .githooks/, and operations/scripts/.
  • Staged and full WCAG accessibility audits for v2/ docs with conservative autofix support for common raw-tag issues.
  • Intake and governance artifacts:
    • issue templates in .github/ISSUE_TEMPLATE/
    • PR templates in .github/pull-request-template-v2.md and .github/pull_request_template.md
  • Pre-commit validations including style, MDX, links/imports, scripts docs, and staged audits.
Primary references:

3) AI + Automation + Pipelines

  • Automated ingestion/update flows for forum, blog, YouTube, releases, showcase data.
  • n8n workflow JSON assets and GitHub Actions alternatives coexist.
  • Community pipeline features including showcase and content aggregation/trending patterns.
Primary references:
  • automations.md
  • v2/resources/documentation-guide/automations-workflows.mdx
  • snippets/data/

4) Product + Content System

  • Product-oriented docs copy and information architecture under v2/pages/.
  • “Zero-to-hero” progression across portals, quickstarts, and deep references.
  • Editorial and governance standards in docs guide + contribution docs.
Primary references:
  • content-system.md
  • v2/resources/documentation-guide/documentation-guide.mdx
  • docs-guide/contributing/contributing.mdx

5) Technical Guides + Domain Coverage

  • Operational guides for gateways, orchestrators, delegators, developers, resources.
  • Long-form reference and troubleshooting paths in role-specific sections.
Primary references:
  • v2/pages/04_gateways/
  • v2/orchestrators/
  • v2/pages/06_delegators/
  • v2/pages/03_developers/

6) Future-Proof Maintenance Automation

  • Script templates enforce self-documenting headers.
  • Script inventory and audit generation are automated.
  • Index generation and SEO/AEO/glossary-supporting scripts live under operations/scripts/.
Primary references:
  • operations/scripts/generators/governance/scaffold/new-script.js
  • operations/scripts/audits/governance/scripts/audit-script-categories.js
  • operations/scripts/snippets/generate-seo.js
  • operations/scripts/snippets/generate-data/scripts/generate-glossary.js

7) Data Integrations and APIs

  • OpenAPI and related API specs in api/.
  • Integrated reference datasets and snippets data in snippets/data/.
  • External feed ingestion supports docs freshness and cross-linking.
Primary references:

8) Documentation Automation About Documentation

  • Generated script/workflow/template indexes in docs-guide/.
  • Generated template preview routes and authoring snippets via operations/scripts/generators/components/library/generate-ui-templates.js.
  • Guardrail checks for docs-guide coverage and README pointers.
Primary references:
  • source-of-truth-policy.md
  • operations/tests/unit/docs-guide-sot.test.js
  • operations/scripts/generators/governance/catalogs/generate-docs-guide-indexes.js
  • operations/scripts/generators/components/library/generate-ui-templates.js
Last modified on April 7, 2026