summaryrefslogtreecommitdiff
path: root/docs/documentation.rst
AgeCommit message (Collapse)Author
2026-05-06feat: flip swap mechanism — MD as primary, RST as override (Phase 1)Yuriy Andamasov
This is the first of three phases inverting the per-page swap mechanism so MD becomes the canonical primary and RST becomes the rare override. Phase 1 — file renames + conf.py exclude_patterns flip only: - Rename docs/**/md-<stem>.md to docs/**/<stem>.md (drop md- prefix) for all 254 stems previously listed in docs/_swap.txt - Rename docs/**/<stem>.rst to docs/**/rst-<stem>.rst (add rst- prefix) for the same 254 stems - Repurpose docs/_swap.txt as docs/_rst_overrides.txt; initially empty comment-only since no pages need the RST fallback right now - conf.py exclude_patterns flipped: rst-*.rst is now excluded by default instead of md-*.md - conf.py runtime-artifact references updated to _rst_override_state.json and _md_exclude.txt (Phase 2 will rewrite swap_sources.py to produce these names; for now no swap script runs because overrides list is empty) Phase 2 (next commit on this branch) will rewrite scripts/swap_sources.py with inverted rename direction, delete scripts/import_myst.py + tests, and update tests/test_swap_sources.py for the new semantics. Phase 3 will be the cleanup pass and ready-for-review flip. Generated by robots https://vyos.io
2025-10-13cla: Add CLA references and instructions (#1690)zdc
- Added a dedicated page describing the process of signing the CLA - Added references to this page on documents explaining how to submit code and documentation changes
2024-04-16fix several build warnings and errorsrebortg
2024-04-16change master to current branch namerebortg
2024-03-07improve documentation how-to and create PR templaterebortg
2024-01-17Fix more typosSebastian Weber
2022-09-26Update documentation.rstNephiaust
Fixed typo in the 'page content' section. "Title" was misspelt.
2022-09-14firewall: T2199: adjust to new 1.4 CLI syntaxChristian Poessinger
"set zone-policy zone <name>" moved to "set firewall zone <name>".
2022-08-16add :defaultvalue: optionrebortg
(cherry picked from commit b09f2222ed6181ba377a41de37a3997559a234c8) (cherry picked from commit 1205c1e7806d4e84e03aafc94831248cbfa9b1c8)
2022-02-12Remove obsolete information about native documentation generationerkin
2021-09-13contributing: clear structurerebortg
2021-08-16Merge contribution documentation and documentation chapterChristian Poessinger
(cherry picked from commit 848c538299fe0098166e052d3238caff60a61915)
2021-06-25documetation: correct spelling and grammarrebortg
2021-06-18documentation: fix build errorrebortg
2021-06-14Documentation: correct grammarRobert Göhler
2021-06-11add autosectionlabel plugin and explanationrebortg
2021-04-05documentation guide - update grammarRicky Pai
2020-12-11documentation: fix lint errorsrebortg
2020-12-11documentation: adjust line lenghtrebortg
2020-12-11linter: fix line lenght detection, strip linebreakrebortg
2020-12-11linter add start/stop function with rst commentsrebortg
2020-12-10rearrange development partrebortg