<feed xmlns='http://www.w3.org/2005/Atom'>
<title>vyos-documentation.git/docs/contributing/debugging.rst, branch rolling</title>
<subtitle>VyOS readthedocs (mirror of https://github.com/vyos/vyos-documentation.git)
</subtitle>
<id>https://git.amelek.net/vyos/vyos-documentation.git/atom?h=rolling</id>
<link rel='self' href='https://git.amelek.net/vyos/vyos-documentation.git/atom?h=rolling'/>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/'/>
<updated>2026-05-06T17:42:32+00:00</updated>
<entry>
<title>feat: flip swap mechanism — MD as primary, RST as override (Phase 1)</title>
<updated>2026-05-06T17:42:32+00:00</updated>
<author>
<name>Yuriy Andamasov</name>
<email>yuriy@vyos.io</email>
</author>
<published>2026-05-06T17:42:32+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=5d6fa52b8985f8068314aba26878a1d7d5cb84e5'/>
<id>urn:sha1:5d6fa52b8985f8068314aba26878a1d7d5cb84e5</id>
<content type='text'>
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-&lt;stem&gt;.md to docs/**/&lt;stem&gt;.md (drop md- prefix)
  for all 254 stems previously listed in docs/_swap.txt
- Rename docs/**/&lt;stem&gt;.rst to docs/**/rst-&lt;stem&gt;.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
</content>
</entry>
<entry>
<title>Proofread docs in the /contributing directory (#1718)</title>
<updated>2026-01-27T09:44:43+00:00</updated>
<author>
<name>Quill</name>
<email>69414602+teslazonda@users.noreply.github.com</email>
</author>
<published>2026-01-27T09:44:43+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=25c8e20b11ad61d2d9872a1932d373199430af6f'/>
<id>urn:sha1:25c8e20b11ad61d2d9872a1932d373199430af6f</id>
<content type='text'>
* 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</content>
</entry>
<entry>
<title>debugging: document new config migration helper</title>
<updated>2024-12-14T08:11:23+00:00</updated>
<author>
<name>Christian Breunig</name>
<email>christian@breunig.cc</email>
</author>
<published>2024-12-14T08:10:07+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=d8f20e7ccd15e42f721d65d96a9e0a1634d89c62'/>
<id>urn:sha1:d8f20e7ccd15e42f721d65d96a9e0a1634d89c62</id>
<content type='text'>
</content>
</entry>
<entry>
<title>Fix spelling in contributing</title>
<updated>2024-01-17T20:40:04+00:00</updated>
<author>
<name>Sebastian Weber</name>
<email>s@web3r.de</email>
</author>
<published>2024-01-17T20:40:04+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=1eef218af2ea9a8f8267d8e42418a680824449ff'/>
<id>urn:sha1:1eef218af2ea9a8f8267d8e42418a680824449ff</id>
<content type='text'>
</content>
</entry>
<entry>
<title>contributing: clear structure</title>
<updated>2021-09-13T17:45:06+00:00</updated>
<author>
<name>rebortg</name>
<email>github@ghlr.de</email>
</author>
<published>2021-09-13T17:45:06+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=e8bd02d5f8018698f656ce7a176157efdaac8c60'/>
<id>urn:sha1:e8bd02d5f8018698f656ce7a176157efdaac8c60</id>
<content type='text'>
</content>
</entry>
<entry>
<title>rearrange development part</title>
<updated>2020-12-10T12:35:30+00:00</updated>
<author>
<name>rebortg</name>
<email>github@ghlr.de</email>
</author>
<published>2020-12-10T12:35:30+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=8bd516a5ff97716b34d254adf6cf9ac0126eb0f1'/>
<id>urn:sha1:8bd516a5ff97716b34d254adf6cf9ac0126eb0f1</id>
<content type='text'>
</content>
</entry>
<entry>
<title>Merge branch 'sagitta' of https://github.com/rebortg/vyos-documentation</title>
<updated>2020-12-08T13:57:44+00:00</updated>
<author>
<name>rebortg</name>
<email>github@ghlr.de</email>
</author>
<published>2020-12-08T13:57:44+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=f6c43343bbea7c98b6e735f5204da1759343ca23'/>
<id>urn:sha1:f6c43343bbea7c98b6e735f5204da1759343ca23</id>
<content type='text'>
</content>
</entry>
<entry>
<title>arrange examples</title>
<updated>2020-12-06T20:41:10+00:00</updated>
<author>
<name>rebortg</name>
<email>github@ghlr.de</email>
</author>
<published>2020-12-06T20:41:10+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=ce090a4ced7fccce3fdc70142e22fa0009fae12b'/>
<id>urn:sha1:ce090a4ced7fccce3fdc70142e22fa0009fae12b</id>
<content type='text'>
</content>
</entry>
<entry>
<title>debugging: add info about vyos-configd</title>
<updated>2020-12-06T16:35:00+00:00</updated>
<author>
<name>Christian Poessinger</name>
<email>christian@poessinger.com</email>
</author>
<published>2020-12-06T16:35:00+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=54b4501f79a199993c440a9dcb1ebc7ad8d7036b'/>
<id>urn:sha1:54b4501f79a199993c440a9dcb1ebc7ad8d7036b</id>
<content type='text'>
</content>
</entry>
<entry>
<title>change include to absolute path</title>
<updated>2020-11-30T18:46:59+00:00</updated>
<author>
<name>rebortg</name>
<email>github@ghlr.de</email>
</author>
<published>2020-11-30T18:46:59+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=e33e1268f944be445b5a771df0e97e913487512f'/>
<id>urn:sha1:e33e1268f944be445b5a771df0e97e913487512f</id>
<content type='text'>
</content>
</entry>
</feed>
