vyos-documentation.git/docs/contributing/issues-features.rst, branch rolling

feat: flip swap mechanism — MD as primary, RST as override (Phase 1)

2026-05-06T17:42:32+00:00

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-.md to docs/**/.md (drop md- prefix) for all 254 stems previously listed in docs/_swap.txt - Rename docs/**/.rst to docs/**/rst-.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

Proofread docs in the /contributing directory (#1718)

2026-01-27T09:44:43+00:00

* Proofread upstream-packages.rst * Fix line length lint errors * Initial copyedit for testing.rst * Proofread build-vyos.rst * Fix line length errors * Proofread debugging.rst * Proofread issues-features.rst * Complete issuesfeatures.rst proofreading * Initial proofread development.rst * Revise proofreading of development.rst * Remove mentions of Phabricator and Jenkins CI * Fix line length lint errors * Fix additional line length lint errors

Docs: refresh the issue/features page guidelines

2024-04-16T18:19:27+00:00

arrange examples

2020-12-06T20:41:10+00:00

change include to absolute path

2020-11-30T18:46:59+00:00

lcd: T2564: adjust to latest CLI

2020-08-15T18:53:00+00:00

issue-feature: fix title overline & underline mismatch

2019-12-29T16:13:44+00:00

issue-feature: use documented section style guide

2019-12-29T10:10:38+00:00

common-references: migrate all VyOS Phabricator references

2019-12-29T10:07:24+00:00

install: overall chapter improvement

2019-12-21T17:03:01+00:00