<feed xmlns='http://www.w3.org/2005/Atom'>
<title>vyos-documentation.git/docs/contributing/testing.md, branch mergify/bp/scutum/pr-2246</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=mergify%2Fbp%2Fscutum%2Fpr-2246</id>
<link rel='self' href='https://git.amelek.net/vyos/vyos-documentation.git/atom?h=mergify%2Fbp%2Fscutum%2Fpr-2246'/>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/'/>
<updated>2026-10-31T13:36:49+00:00</updated>
<entry>
<title>T3871: bind interface names to hardware slots instead of hw-id (#2246)</title>
<updated>2026-10-31T13:36:49+00:00</updated>
<author>
<name>Christian Breunig</name>
<email>christian@breunig.cc</email>
</author>
<published>2026-10-31T10:53:23+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=85a68daba040410f1f2cb5e9ded80d23643e61c8'/>
<id>urn:sha1:85a68daba040410f1f2cb5e9ded80d23643e61c8</id>
<content type='text'>
* docs: T3871: describe how interface names are assigned

Names are no longer derived from the hw-id node. They are bound to the slot
the hardware occupies and recorded in a mapping file, so document what
decides a name, what happens when a card is replaced or added, and how to
rename an interface.

The troubleshooting page said to pin a MAC with hw-id when interfaces were
renamed after a VM migration or a clone. That node no longer exists and the
situation it describes no longer arises, so replace it with a pointer to the
new section and a note on where to look when an interface really is missing.

* docs: T3871: drop hw-id from the example output

The node is gone from the CLI, so example configuration dumps which still
show it no longer match what a reader sees on their own system. Remove it
from the shown output only; no prose changes. The comparison shown on the
testing page is rewritten rather than trimmed, as deleting the lines would
have left an edit level behind with nothing under it.

(cherry picked from commit f939f4eb05f55e7e4c81e1b5dc954c3fc06d2389)
</content>
</entry>
<entry>
<title>feat: flip swap mechanism on circinus — MD as primary, RST as override</title>
<updated>2026-05-06T18:08:17+00:00</updated>
<author>
<name>Yuriy Andamasov</name>
<email>yuriy@vyos.io</email>
</author>
<published>2026-05-06T18:08:17+00:00</published>
<link rel='alternate' type='text/html' href='https://git.amelek.net/vyos/vyos-documentation.git/commit/?id=3edf063d4d27d6132c67024b9560c0075fe7a48e'/>
<id>urn:sha1:3edf063d4d27d6132c67024b9560c0075fe7a48e</id>
<content type='text'>
Mirror of #1899 for circinus. Same logic, same scripts, per-branch file set.

Changes:
- Rename docs/**/md-&lt;stem&gt;.md to docs/**/&lt;stem&gt;.md (drop md- prefix) for
  all 253 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 253 stems
- Repurpose docs/_swap.txt as docs/_rst_overrides.txt; initially empty
- conf.py exclude_patterns flipped: rst-*.rst excluded by default
- conf.py runtime-artifact references updated to _rst_override_state.json
  and _md_exclude.txt
- scripts/swap_sources.py rewritten with inverted rename direction
  (rst-&lt;stem&gt;.rst → &lt;stem&gt;.rst when applying overrides; &lt;stem&gt;.md
  excluded via _md_exclude.txt)
- scripts/import_myst.py and tests/test_import_myst.py deleted (obsolete)
- tests/test_swap_sources.py rewritten for new semantics

Identical change set to #1899 (current). Per-branch differences:
- circinus has 253 stems vs current's 254 (suricata is current-only)
- otherwise the script/conf.py/test changes are byte-identical with current

Generated by robots https://vyos.io
</content>
</entry>
</feed>
