summaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)Author
2026-04-15refactor: use builder-inited hook for WebP image type overrideYuriy Andamasov
Replaces class-level patching of StandaloneHTMLBuilder/DirectoryHTMLBuilder with a builder-inited event hook that only modifies html, dirhtml, and readthedocs builders. This avoids unintentionally affecting EPUB or HTMLHelp builders that inherit from StandaloneHTMLBuilder. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15fix: also patch DirectoryHTMLBuilder for WebP priorityYuriy Andamasov
ReadTheDocs uses a builder that subclasses DirectoryHTMLBuilder, not StandaloneHTMLBuilder. Patch both to ensure WebP is preferred in all HTML build variants. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15fix: configure Sphinx to prefer WebP for HTML outputYuriy Andamasov
Sphinx 7.2.x does not include image/webp in the HTML builder default supported_image_types, so wildcard references resolved to PNG. Patch the priority list so HTML builds select WebP while LaTeX stays unaffected. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15perf: convert all images to WebP with PDF fallbackYuriy Andamasov
Add WebP versions of all 187 PNG/JPG images (38MB → 17MB, 55% reduction). Update RST/MD references to use Sphinx wildcard syntax (.*) so HTML builds use WebP while PDF/LaTeX builds fall back to original PNG/JPG. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-14feat: LLM documentation adaptation (llms.txt, sitemap, robots.txt) (#1832)Yuriy Andamasov
* feat: add sphinx-llms-txt and sphinx-sitemap dependencies Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat: register sphinx-llms-txt and sphinx-sitemap extensions Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat: add curated llms.txt for LLM discovery Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat: update robots.txt with explicit AI bot allowances Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: configure sphinx-llms-txt and sphinx-sitemap options Disable auto-generated llms.txt (curated version served from _html_extra instead). Set sitemap_url_scheme to avoid doubled lang/version path segments since html_baseurl already includes /en/latest/. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10docs: reformat wireless.rst for readability (#1826)Yuriy Andamasov
* docs: reformat wireless.rst for readability and consistency Reformat wireless interface documentation: standardize heading hierarchy, rewrap long lines, fix code-block indentation, and improve overall structure for readability. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: fix content regressions in wireless.rst reformat Restore original wording incorrectly changed during reformat: - Title: 'Wireless LAN / Wi-Fi' (not 'WLAN/WIFI') - lastproofread: 2026-03-23 (not 2024-07-04) - 'System-wide' (not 'System Wide') - 'may be rejected' (not 'maybe rejected') - '802.1X' (not '802.1x') - 'electromagnetic damping' (not 'electro-magnetic dampening') - Throughput units: '10 MB/s', '50 MB/s' (not '10MBytes/s') - Restore channel description with automatic selection (0) - Fix opcmd grammar Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: restore upstream prose wording in wireless.rst Address review feedback from @dmbaturin — restore original wording where prose was unnecessarily rewritten: - Restore intro paragraph (remove 'by means of compatible hardware') - Restore 'Resulting configuration:' (was changed to 'Resulting in') - Restore concise AP/Wi-Fi 6 setup text and section headers - Keep formatting improvements (line wrapping, heading hierarchy) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: restore more upstream wording in wireless.rst Restore original text at three more locations: - Use backtick-quoted access-point mode (CLI token style) - Restore device type bullet formatting with colons and abbr - Restore HT40 channel availability note wording Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10docs: fix typos and prose in terraform, ansible, and config docs (#1829)Yuriy Andamasov
* docs: fix typos and improve prose in terraform, ansible, and config docs Fix typos (VyoS→VyOS, respresent→represents), rewrap long prose lines for readability, restore correct YAML indentation in Ansible examples, and standardize heading hierarchy in affected files. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: replace public DNS IP with RFC 5737 address in NMP example Use 198.51.100.1 (TEST-NET-2) instead of 8.8.8.8 to satisfy the documentation linter requirement for reserved addresses. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: restore linter markers around NMP code block with 8.8.8.8 Restore stop/start_vyoslinter markers that were incorrectly removed. The DNS server address is intentional and should not be changed. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10docs: remove TODO markers, fix stub notes, add linter markers (#1828)Yuriy Andamasov
Remove TODO tracking comments, reformat stub notes with inline links, add stop/start_vyoslinter markers around long code blocks, and fix minor structural issues across 23 documentation files. Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10docs: standardize RST heading hierarchy to # overline across 21 files (#1827)Yuriy Andamasov
Normalize top-level page headings from = or * underline-only to # overline+underline format, following RST/Sphinx best practices for consistent heading hierarchy. Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10docs: fix code-block indentation (tabs to spaces) (#1825)Yuriy Andamasov
* docs: fix tab-to-space indentation in code blocks across 5 files Replace tab characters with spaces inside code-block and output directives for consistent rendering. Also rewrap long prose lines for readability. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * chore: remove accidentally committed settings file Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: fix inconsistent indentation in trafficpolicy and qos code blocks Normalize indentation within code blocks where tab-to-space conversion left some entries misaligned (tbit, gibps, tibps in trafficpolicy; egress command in qos). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10remote: T4732: add VRF option for commit-archive (#1823)Christian Breunig
2026-04-10isis: T6978: add IS-IS SRv6 configuration (#1760)Jonathan Voss
2026-04-10Proofread files in the /configuration/firewall directory (#1810)Quill
* Initial proofread * Edit ipv6.rst * Use cfgcmd command syntax * Fix line length lint errors * Implement feedback
2026-04-10T8189: Add conntrackd FTFW PurgeTimeout setting (#1819)Nataliia S.
2026-04-09Proofread docs in the /automation/terraform directory (#1800)Quill
* Proofread terraformAWS.rst * Proofread terraformAZ.rst * Edit terraformGoogle.rst * Edit terraformvSphere.rst * Move directory of Terraform guides into terraform/index * Fix line length lint errors * Fix addtional line length lint errors
2026-04-09DOC: Proofread files in the /configuration/loadbalancing directory (#1821)Quill
* Initial proofread * Fix line length lint errors
2026-04-07T8046: traffic-engineering (#1726)Kyrylo Yatsenko
2026-04-03DOC: Proofread command-scripting.rst (#1813)LiudmylaNad
2026-04-03DOC: Add CLIs and their description for VTIs (#1811)LiudmylaNad
2026-04-03DOC: Proofread wwan.rst (#1812)LiudmylaNad
2026-03-30Add TODO markers, fill placeholders, mark stub pages (#1802)Yuriy Andamasov
* chore: add TODO markers for 12 files needing cfgcmd/opcmd conversion Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix: fill TBD placeholder in flow-accounting, remove TBD in static routes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: add stub admonitions to 3 minimal pages Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix: replace non-RFC IP addresses and suppress false positives in linter Replace public IPs with RFC 5737 documentation addresses and add stop/start_vyoslinter markers for false positives (MAC addresses, OIDs, NAT64 well-known prefix). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix: replace remaining non-RFC IPs and suppress MAC address false positive - Replace 8.8.8.8 (Google DNS) with 192.0.2.1 (RFC 5737) in: - docs/configexamples/ansible.rst (3 occurrences) - docs/configexamples/nmp.rst (1 occurrence) - docs/automation/terraform/terraformvSphere.rst (1 occurrence) - Wrap SHA-256 certificate fingerprint in openvpn-examples.rst with stop_vyoslinter/start_vyoslinter to suppress false-positive IPv6 flag Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix: wrap long lines to comply with 80-char line length limit Wrapped prose content exceeding 80 characters in 9 documentation files. Only RST prose and directive content was modified; code block contents were left untouched as they are exempt from the linter. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix: wrap 2 remaining long lines for linter compliance Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: suppress linter for long URL reference in terraformvSphere.rst * fix: address Copilot review suggestions — broken links, typos, YAML indentation - Fix broken inline RST links split across lines in sysctl.rst, eve-ng.rst, oracle.rst (stub notes with VyOS documentation repository link) - Fix YAML indentation in both playbook code blocks in ansible.rst - Fix typo "VyoS" -> "VyOS" in ansible.rst - Fix typo "desition" -> "decision" in terraformvSphere.rst - Fix 4 occurrences of "Terrafom" -> "Terraform" in terraformvSphere.rst - Fix :doc: role split across two lines in openvpn-examples.rst - Wrap long paragraph in openconnect.rst to <=80 chars and remove unnecessary stop/start_vyoslinter markers Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix: resolve remaining linter failures — long lines and OID false positive Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix: revert 8.8.8.8 replacements, use stop_vyoslinter instead --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-30Split troubleshooting, add contributing index, clean VPN structure (#1804)Yuriy Andamasov
* Add design spec for documentation improvements Covers 4 work streams: mechanical fixes (headings, indentation, typos), content quality (TODO flags, TBD fills, stub markers), structural reorganization (troubleshooting split, contributing index, VPN cleanup), and RTD platform cleanup (hide versions, delete stale redirects). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Fix spec issues from review: correct heading chars, tab counts, line numbers Addresses 10 reviewer findings: corrected heading character types (^ was actually -), removed ip.rst (already correct), updated file count from 37 to 35, listed all 13 tab-containing files, fixed troubleshooting line count to 460, added heading level guidance for split pages, clarified contributing/documentation.rst scope, removed current from hide list, added rollback verification step, updated success criteria. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Add implementation plan for documentation improvements 16 tasks across 4 work streams: mechanical fixes (PR 1, tasks 1-6), content quality (PR 2, tasks 7-10), structural reorg (PR 3, tasks 11-14), and RTD platform cleanup (tasks 15-16). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Fix 6 issues from plan review - Replace hardcoded RTD token with $RTD_TOKEN variable - Fix Task 7 heading reference to be format-agnostic - Correct RTD PATCH expected response (200, not 204) - Fix version verification to check hidden field, not active - Account for blank lines 402-403 in troubleshooting split - Clarify start/stop_vyoslinter handling in system.rst Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * refactor: split troubleshooting into 5 focused sub-pages Split monolithic 460-line troubleshooting/index.rst into: - connectivity.rst (ping, traceroute, mtr, IPv6 discovery) - interfaces.rst (interface naming, MAC addresses) - monitoring.rst (traffic dumps, bandwidth, iperf) - terminal.rst (console clearing, counter resets) - system.rst (boot steps, system information) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * refactor: create contributing/index.rst, simplify root toctree * fix: remove 'pages to sort' placeholders from VPN section * fix: wrap long lines in index.rst for linter compliance * Add design spec for sitemap generation improvement * Fix sitemap spec: remove invalid sitemap_excludes, add version pin * fix: address Copilot review suggestions — grammar, typos, RST markup fixes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix: resolve remaining long lines in index.rst Shorten :ref: display text on two lines that exceeded the 80-char limit: "Virtual Environment" -> "VM" (line 24, 90 -> 73 chars) and "Configuration Blueprints" -> "Blueprints" (line 51, 85 -> 71 chars). Both targets remain correct; display text is clear in context. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * chore: remove superpowers specs from PR Specs moved to personal branch yuriy/docs-modernization-specs. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-30DOC: Proofread wireless.rst (#1806)LiudmylaNad
* DOC: Proofread wireless.rst * Apply suggestion from @dmbaturin --------- Co-authored-by: Daniil Baturin <daniil@baturin.org>
2026-03-30docs: add documentation modernization specs and project summaryYuriy Andamasov
Six design specs covering LLM adaptation, RST→MyST migration, Cloudflare hosting, visual editor, mobile performance, and visitor tracking. Includes project summary PDF for team sharing. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26T8433: remove changelogs from documentation (#1809)Daniil Baturin
They are kept in Phorge and the KB and do not need to be duplicated here
2026-03-21Fix 6 issues from plan reviewYuriy Andamasov
- Replace hardcoded RTD token with $RTD_TOKEN variable - Fix Task 7 heading reference to be format-agnostic - Correct RTD PATCH expected response (200, not 204) - Fix version verification to check hidden field, not active - Account for blank lines 402-403 in troubleshooting split - Clarify start/stop_vyoslinter handling in system.rst Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21Add implementation plan for documentation improvementsYuriy Andamasov
16 tasks across 4 work streams: mechanical fixes (PR 1, tasks 1-6), content quality (PR 2, tasks 7-10), structural reorg (PR 3, tasks 11-14), and RTD platform cleanup (tasks 15-16). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21Fix spec issues from review: correct heading chars, tab counts, line numbersYuriy Andamasov
Addresses 10 reviewer findings: corrected heading character types (^ was actually -), removed ip.rst (already correct), updated file count from 37 to 35, listed all 13 tab-containing files, fixed troubleshooting line count to 460, added heading level guidance for split pages, clarified contributing/documentation.rst scope, removed current from hide list, added rollback verification step, updated success criteria. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21Add design spec for documentation improvementsYuriy Andamasov
Covers 4 work streams: mechanical fixes (headings, indentation, typos), content quality (TODO flags, TBD fills, stub markers), structural reorganization (troubleshooting split, contributing index, VPN cleanup), and RTD platform cleanup (hide versions, delete stale redirects). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20vpp: T8315: Update NIC requirements and add supported hardware list (#1792)Alexandr K.
2026-03-17Proofread files in /vpp/configuration/interfaces directory (#1793)Quill
* Proofread bonding.rst * Proofread bridge.rst * Edit remaining files in /interfaces * Fix line length lint errors * Apply suggestions from code review Co-authored-by: Daniil Baturin <daniil@baturin.org> --------- Co-authored-by: Daniil Baturin <daniil@baturin.org>
2026-03-17Proofread files in the /vpp/configuration/nat directory (#1785)Quill
* Initial proofread * Fix indent in nat44.rst * Fix line length lint errors * Apply suggestion from @dmbaturin --------- Co-authored-by: Daniil Baturin <daniil@baturin.org>
2026-03-17DOC: Proofread openvpn-examples.rst (#1779)LiudmylaNad
* DOC: Proofread openvpn-examples.rst * Apply suggestions from code review Co-authored-by: Daniil Baturin <daniil@baturin.org> --------- Co-authored-by: Daniil Baturin <daniil@baturin.org>
2026-03-17DOC: Proofread vxlan.rst (#1797)LiudmylaNad
2026-03-17DOC: Proofread sstp-client.rst (#1798)LiudmylaNad
2026-03-17DOC: Proofread pppoe.rst (#1790)LiudmylaNad
Remove superfluous information not related to PPPoE interface configuration in VyOS Co-authored-by: Daniil Baturin <daniil@baturin.org>
2026-03-16DOC: Proofread wireguard.rst (#1784)LiudmylaNad
* DOC: Proofread wireguard.rst * Apply suggestions from code review Co-authored-by: Daniil Baturin <daniil@baturin.org> --------- Co-authored-by: Daniil Baturin <daniil@baturin.org>
2026-03-16DOC: Proofread pseudo-ethernet.rst (#1791)LiudmylaNad
* DOC: Proofread pseudo-ethernet.rst --------- Co-authored-by: Daniil Baturin <daniil@baturin.org>
2026-03-16DOC: Add information about execute permissions. (#1796)LiudmylaNad
2026-03-16Merge branch 'current' into syslog-clichksrividya0208
2026-03-12fix ISIS config commands examplesAlex Kudentsov
2026-03-11Correction of syslog and isis cli commands as per the latest versionsrividya0208
2026-03-09Merge pull request #1789 from natali-rs1985/T8354Viacheslav Hletenko
vpp: T8354: Move 'ignore-kernel-routes' option out of resource-allocation section
2026-03-06vpp: T8354: Move 'ignore-kernel-routes' option out of resource-allocation ↵Nataliia Solomko
section
2026-03-06Fix typoSting Alleman
2026-03-05vpp: Move interfaces from vpp section to 'interfaces vpp'Nataliia Solomko
2026-03-05doc: proofread docs in /vpp/configuration/dataplane directory (#1777)Quill
* Initial proofread * buffers.rst * cpu.rst * index.rst * interface.rst * proofread ipsec.rst * Proofread ipv6, l2learn, lcp * Proofread remaining files in /dataplane * Fix line length lint errors
2026-03-05T7513: DOC: VPP CGNAT Exclude Rule (#1786)RC
* T7513: DOC: VPP CGNAT Exclude Rule * T7513: Doc CGNAT Exclude rule - fix linter errors
2026-03-05T8136: IPSEC PPK Support (#1733)Giga Murphy
* T8136: IPSEC PPK Support * Fix styling and capitalization issues. --------- Co-authored-by: Daniil Baturin <daniil@baturin.org>
2026-03-04Merge pull request #1780 from natali-rs1985/T8283Nataliia S.
vpp: T8283: Move bonding interface from vpp section to 'interfaces vpp bonding'
generated by cgit v1.2.3 (git 2.39.1) at 2026-07-14 18:24:52 +0000