README

dDocs is the file-first documentation browser and documentation standard surface for Evolution CMS manager packages. It discovers package Markdown, builds a safe tree, renders documents in the manager, and keeps project-owned notes as files.

Languages

• English
• Українська
• Deutsch
• Francais
• Polski

Each supported dDocs language folder contains:

• README.md - localized overview and navigation.
• user-guide.md - manager user workflows and visible behavior.
• developer-guide.md - architecture, package integration, routes, and checks.

Additional files are conditional. dDocs includes configuration.md, reference.md, troubleshooting.md, and frontend-guide.md because it has settings, routes, a file index, and a browser viewer runtime.

Locale Status

Read This First

Language Policy

Ukrainian documentation uses uk only. Legacy Evolution manager values such as ua are normalized internally to uk; do not create docs/ua, list ua as a documentation locale, or add ua to docs manifests.

Canonical Guides

• Documentation Standards
• Ukrainian Documentation Standards
• Configuration
• Reference
• Troubleshooting
• Contributing To Documentation
• Glossary And Word List
• Assets Policy
• Package And Product Documentation
• Docs Manifest
• AI And Agent Readiness
• Migration Guide
• Legacy Evolution Docs Strategy
• Markdown Example

Package Documentation Contract

New Evolution packages should use a lowercase docs/ root:

docs/
  README.md
  assets/
    images/
    diagrams/
  en/
    README.md
    user-guide.md
    developer-guide.md
  uk/
    README.md
    user-guide.md
    developer-guide.md

The minimum user-facing locale set is English, Ukrainian (uk), Polish, German, and French. Packages may keep Russian as a legacy extra when they already ship it.

dDocs Navigation Contract

• All package entrypoints must stay inside this docs/ tree.
• Localized READMEs are navigation and onboarding pages, not generated task logs.
• Internal links must be relative and must resolve inside the package source.
• Code fences must include language identifiers so dTui and Prism can highlight and copy them consistently.
• Images must live under docs/assets/images/ or another path inside the docs root. dDocs blocks paths that escape safe roots.
• Old generated documentation sites should move to docs_old/ so dDocs does not index Docusaurus, Jekyll, build config, or generated static files.