121 Manual

Tip

Read the manual: https://manual.121.global

Development

Getting Started

With Python

• Install a Python virtual environment (On Linux/macOS):

  python3 -m venv venv
  source venv/bin/activate

• Install dependencies

  pip install -r requirements.txt

• Build the documentation (for each language separately):

  • For English, preview at: http://localhost:8000

    mkdocs serve --config-file config/en/mkdocs.yml --dev-addr localhost:8000

  • For Dutch, preview at: http://localhost:8080

    mkdocs serve --config-file config/nl/mkdocs.yml --dev-addr localhost:8080

  • For French, preview at: http://localhost:8003

    mkdocs serve --config-file config/fr/mkdocs.yml --dev-addr localhost:8003

Tools in use

• Material for MkDocs: https://squidfunk.github.io/mkdocs-material/

Deployment notes

• The Azure Static Web App config includes explicit CORS rules for en/faq/* and fr/faq/*.
• Reason: FAQ pages from this manual are embedded in a 510.global context (Using in-page JS, using fetch().), so Access-Control-Allow-Origin: https://510.global must remain in staticwebapp.config.json for those routes.

Copilot and PR guidance

• Repository-wide Copilot instructions for translation and ToC-anchor safety are in .github/copilot-instructions.md.
• Pull request guidance and translation/ToC checklists are in .github/pull_request_template.md.