diff options
| author | Yuriy Andamasov <yuriy@vyos.io> | 2026-05-06 20:42:32 +0300 |
|---|---|---|
| committer | Yuriy Andamasov <yuriy@vyos.io> | 2026-05-06 20:42:32 +0300 |
| commit | 5d6fa52b8985f8068314aba26878a1d7d5cb84e5 (patch) | |
| tree | 99359ff282846e26b5c5fa2b9b176b35b172809f /docs/contributing | |
| parent | 631e454d674ad5111d2b56a6964ead461894a1f6 (diff) | |
| download | vyos-documentation-5d6fa52b8985f8068314aba26878a1d7d5cb84e5.tar.gz vyos-documentation-5d6fa52b8985f8068314aba26878a1d7d5cb84e5.zip | |
feat: flip swap mechanism — MD as primary, RST as override (Phase 1)
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
Diffstat (limited to 'docs/contributing')
| -rw-r--r-- | docs/contributing/build-vyos.md (renamed from docs/contributing/md-build-vyos.md) | 0 | ||||
| -rw-r--r-- | docs/contributing/cla.md (renamed from docs/contributing/md-cla.md) | 0 | ||||
| -rw-r--r-- | docs/contributing/debugging.md (renamed from docs/contributing/md-debugging.md) | 0 | ||||
| -rw-r--r-- | docs/contributing/development.md (renamed from docs/contributing/md-development.md) | 0 | ||||
| -rw-r--r-- | docs/contributing/index.md (renamed from docs/contributing/md-index.md) | 0 | ||||
| -rw-r--r-- | docs/contributing/issues-features.md (renamed from docs/contributing/md-issues-features.md) | 0 | ||||
| -rw-r--r-- | docs/contributing/rst-build-vyos.rst (renamed from docs/contributing/build-vyos.rst) | 0 | ||||
| -rw-r--r-- | docs/contributing/rst-cla.rst (renamed from docs/contributing/cla.rst) | 0 | ||||
| -rw-r--r-- | docs/contributing/rst-debugging.rst (renamed from docs/contributing/debugging.rst) | 0 | ||||
| -rw-r--r-- | docs/contributing/rst-development.rst (renamed from docs/contributing/development.rst) | 0 | ||||
| -rw-r--r-- | docs/contributing/rst-index.rst (renamed from docs/contributing/index.rst) | 0 | ||||
| -rw-r--r-- | docs/contributing/rst-issues-features.rst (renamed from docs/contributing/issues-features.rst) | 0 | ||||
| -rw-r--r-- | docs/contributing/rst-testing.rst (renamed from docs/contributing/testing.rst) | 0 | ||||
| -rw-r--r-- | docs/contributing/rst-upstream-packages.rst (renamed from docs/contributing/upstream-packages.rst) | 0 | ||||
| -rw-r--r-- | docs/contributing/testing.md (renamed from docs/contributing/md-testing.md) | 0 | ||||
| -rw-r--r-- | docs/contributing/upstream-packages.md (renamed from docs/contributing/md-upstream-packages.md) | 0 |
16 files changed, 0 insertions, 0 deletions
diff --git a/docs/contributing/md-build-vyos.md b/docs/contributing/build-vyos.md index bfda5298..bfda5298 100644 --- a/docs/contributing/md-build-vyos.md +++ b/docs/contributing/build-vyos.md diff --git a/docs/contributing/md-cla.md b/docs/contributing/cla.md index 01323111..01323111 100644 --- a/docs/contributing/md-cla.md +++ b/docs/contributing/cla.md diff --git a/docs/contributing/md-debugging.md b/docs/contributing/debugging.md index d3b4b513..d3b4b513 100644 --- a/docs/contributing/md-debugging.md +++ b/docs/contributing/debugging.md diff --git a/docs/contributing/md-development.md b/docs/contributing/development.md index 8d2cec40..8d2cec40 100644 --- a/docs/contributing/md-development.md +++ b/docs/contributing/development.md diff --git a/docs/contributing/md-index.md b/docs/contributing/index.md index f26a6b70..f26a6b70 100644 --- a/docs/contributing/md-index.md +++ b/docs/contributing/index.md diff --git a/docs/contributing/md-issues-features.md b/docs/contributing/issues-features.md index ab235326..ab235326 100644 --- a/docs/contributing/md-issues-features.md +++ b/docs/contributing/issues-features.md diff --git a/docs/contributing/build-vyos.rst b/docs/contributing/rst-build-vyos.rst index 65298a7a..65298a7a 100644 --- a/docs/contributing/build-vyos.rst +++ b/docs/contributing/rst-build-vyos.rst diff --git a/docs/contributing/cla.rst b/docs/contributing/rst-cla.rst index c19e266a..c19e266a 100644 --- a/docs/contributing/cla.rst +++ b/docs/contributing/rst-cla.rst diff --git a/docs/contributing/debugging.rst b/docs/contributing/rst-debugging.rst index da8186ae..da8186ae 100644 --- a/docs/contributing/debugging.rst +++ b/docs/contributing/rst-debugging.rst diff --git a/docs/contributing/development.rst b/docs/contributing/rst-development.rst index 5de950df..5de950df 100644 --- a/docs/contributing/development.rst +++ b/docs/contributing/rst-development.rst diff --git a/docs/contributing/index.rst b/docs/contributing/rst-index.rst index 18b925ec..18b925ec 100644 --- a/docs/contributing/index.rst +++ b/docs/contributing/rst-index.rst diff --git a/docs/contributing/issues-features.rst b/docs/contributing/rst-issues-features.rst index b1e1d732..b1e1d732 100644 --- a/docs/contributing/issues-features.rst +++ b/docs/contributing/rst-issues-features.rst diff --git a/docs/contributing/testing.rst b/docs/contributing/rst-testing.rst index d7455103..d7455103 100644 --- a/docs/contributing/testing.rst +++ b/docs/contributing/rst-testing.rst diff --git a/docs/contributing/upstream-packages.rst b/docs/contributing/rst-upstream-packages.rst index c740b190..c740b190 100644 --- a/docs/contributing/upstream-packages.rst +++ b/docs/contributing/rst-upstream-packages.rst diff --git a/docs/contributing/md-testing.md b/docs/contributing/testing.md index b68cad1b..b68cad1b 100644 --- a/docs/contributing/md-testing.md +++ b/docs/contributing/testing.md diff --git a/docs/contributing/md-upstream-packages.md b/docs/contributing/upstream-packages.md index fe01df82..fe01df82 100644 --- a/docs/contributing/md-upstream-packages.md +++ b/docs/contributing/upstream-packages.md |
