vyos-documentation.git/AGENTS.md, branch 1.5

docs(agents): wrap CI vyoslinter bullet to 80 chars

2026-05-13T21:26:14+00:00

The new bullet added in the linter-inline commit (75e907d4) was 154 chars on one line. Match the file's documented 80-char rule. 🤖 Generated by [robots](https://vyos.io)

ci: inline doc-linter on circinus to match rolling

2026-05-13T21:12:32+00:00

The lint workflow on this branch referenced `vyos/.github/.github/workflows/lint-doc.yml@current`, which no longer exists in `vyos/.github` — `lint-doc.yml` was dropped from the central workflow set during the move toward repo-local linters. The reusable-workflow `uses:` line has been silently failing (no `doc-lint` check on recent circinus PRs). Mirror rolling's approach (inlined 2026-05-10): - Add `scripts/doc-linter.py` in this repo. Sourced from PR #2014's HEAD on rolling (the version that includes the `is_docs_path()` docs/-only scope guard so repo-root meta files like AGENTS.md and README.md are out of scope, plus the realpath / narrow-exception / Ruff fixes from that PR's review pass). - Replace `.github/workflows/lint-doc.yml` with an in-repo workflow that runs `python scripts/doc-linter.py "$FILES_MODIFIED"` against the changed-file list from `trilom/file-changes-action`. Same job shape as rolling. - Update the `## Lint` and `## CI` bullets in AGENTS.md to point at the in-repo paths. This restores actual lint coverage on circinus PRs and keeps the toolchain identical across rolling / circinus / sagitta. Behavior on the 11 remaining `.rst` pages is unchanged — the linter's SUPPORTED_EXTS already covers `.md`, `.rst`, and `.txt`. 🤖 Generated by [robots](https://vyos.io)

docs: wrap new AGENTS lines for vyoslinter

2026-05-13T21:07:47+00:00

Agent-Logs-Url: https://github.com/vyos/vyos-documentation/sessions/6fab9356-fd51-4ab9-9815-59e15a2413ac Co-authored-by: andamasov <12631358+andamasov@users.noreply.github.com>

docs: refresh README + AGENTS source-format claim for circinus

2026-05-13T21:03:00+00:00

Adapted from PR #2014 on rolling, tailored to this branch's actual state. This branch (circinus, 1.5.x LTS) is mostly migrated to MyST Markdown. 11 RST pages remain in the build alongside the .md set: - docs/changelog/index.rst + docs/changelog/{1.2.1..1.2.6, 1.3, 1.4, 1.5}.rst (auto-generated; stayed RST) - docs/automation/terraform/terraformvyos.rst source_suffix in docs/conf.py is `['.rst', '.md']` to cover both. Changes: - README.md: new `## Source format` section naming the legacy RST pages, pointing at the `_rst_legacy/` archive, and noting the MyST-fence form for VyOS command directives in .md pages. The `## Contributing` blurb drops the now-imprecise "MyST for migrated pages, RST for the rest" phrasing. - AGENTS.md: `## Project` and `### Source files` sections updated to enumerate the 11 remaining RST pages explicitly so contributors know which files are still RST and which to write as MyST. Linter origin claim ("doc-linter.py from the vyos/.github repo") left intact — that script is NOT inlined on this branch (the inline move on rolling at 2026-05-10 has not been backported to circinus). 🤖 Generated by [robots](https://vyos.io)

docs: refresh README + sweep stale `current` refs in AGENTS.md

2026-05-10T15:06:54+00:00

- Rewrite README.md: drop Python 2 install dance, drop `sphinx-panels` (removed years ago), drop `sudo pip install` antipattern, replace with venv + requirements.txt path. Refresh the branch table to current naming, point contributors at AGENTS.md for the full guide. Refresh the docs status badge to reference `rolling` (was `latest`). - AGENTS.md: replace remaining `current` branch references with `rolling` in the branch table, the "PRs target …" line, and the RTD layout table Branch column. The default branch was renamed `current` → `rolling` on 2026-05-10 (commit 8dbf8b05 only swept CI). 🤖 Generated by [robots](https://vyos.io)

chore: remove RST swap mechanism, archive rst-*.rst under docs/_rst_legacy/

2026-05-10T14:23:58+00:00

The swap mechanism (RST-as-fallback for migrated MD pages) is dormant — docs/_rst_overrides.txt has been empty since the MyST flip trio (#1899/#1900/#1901) landed. The mechanism's surface area is dead weight and the rst-*.rst shadows scattered across the source tree cause Context7's parser to misclassify the project as RST. Sibling PR on rolling: yuriy/remove-rst-swap-mechanism Changes: - Move 253 rst-*.rst shadow files into docs/_rst_legacy/ preserving subdirectory structure. They remain in the repo for reference; Sphinx excludes the folder via exclude_patterns. - Strip swap_sources.py invocation from docs/Makefile. - Strip jobs: pre_build/post_build block from .readthedocs.yml. - Strip rst-*.rst exclude entry and the _md_exclude.txt loader from docs/conf.py; replace with a single _rst_legacy exclude. - Delete scripts/swap_sources.py, tests/test_swap_sources.py, docs/_rst_overrides.txt. - Update AGENTS.md: drop the "RST override mechanism" section and the test-runner snippet for the deleted test. Verified: sphinx-build -b html with --keep-going produces identical warning set (68 unique), identical sitemap entry count (267), identical llms.txt entry count (22), zero rst-* URLs in any artifact. 🤖 Generated by [robots](https://vyos.io)

fix(agents-md): add language tag to Mergify command fenced block

2026-05-07T14:09:05+00:00

🤖 Generated by [robots](https://vyos.io) (cherry picked from commit 2d061ba98ea19c9ab66f09fd29408280dacecb52)

docs(agents-md): Mergify commands work in comments only, not PR body

2026-05-07T14:09:05+00:00

🤖 Generated by [robots](https://vyos.io) (cherry picked from commit 4b38218f03aa13b3ae43eb56cde385f6a66949e2)

docs(agents-md): document bot review workflow (Copilot=draft, CodeRabbit=ready)

2026-05-07T14:09:04+00:00

Copilot review must only be triggered on draft PRs. CodeRabbit review must only be triggered on ready-for-review PRs. Auto-reviews are disabled on this repo so CodeRabbit requires manual trigger. 🤖 Generated by [robots](https://vyos.io) (cherry picked from commit 34720ce1d2c0d149fd5e1867a398d2c49b33ce0f)

general: T8595: switch CLAUDE.md to AGENTS.md (+ Copilot symlink)

2026-05-07T13:08:01+00:00

(cherry picked from commit 9d84dabbe420f77ea61e125544556c7769bfb20b) # Conflicts: # .github/copilot-instructions.md