diff options
| author | Yuriy Andamasov <yuriy@vyos.io> | 2026-05-13 23:18:29 +0300 |
|---|---|---|
| committer | Mergify <37929162+mergify[bot]@users.noreply.github.com> | 2026-05-13 22:05:52 +0000 |
| commit | e00e8e38476742ad23c627f77f0e1525f8f7495f (patch) | |
| tree | eb7f6af963d254713471b2ca8748c6f6942cfebb /docs/_static/css/code-snippets.css | |
| parent | f6e0e60c379814a8f1da4daac7a516803c04d6bb (diff) | |
| download | vyos-documentation-e00e8e38476742ad23c627f77f0e1525f8f7495f.tar.gz vyos-documentation-e00e8e38476742ad23c627f77f0e1525f8f7495f.zip | |
fix(includes): rewrite need_improvement.txt as MyST so plain `{include}` renders correctly
After the RST→MyST migration, ~45 MD pages use the plain `{include}` MyST
directive to pull in `_include/need_improvement.txt`. The included file
still contained RST (`.. raw:: html`, `.. raw:: latex`, `:ref:`), and
MyST's built-in `{include}` parses the content with the *outer* file's
parser — i.e. as MyST. RST directives then render as literal paragraphs.
Visible symptom on docs.vyos.io/en/rolling (and across 1.5/1.4):
the VPP index, VPP subpages, haproxy, isis, bfd, policy, pki, salt,
flowtables, webproxy, and others all show:
.. raw:: latex
\iffalse
.. raw:: html
Call for Contributions
Help improve this section ...
For contribution guidelines, see :ref: documentation .
Fix: rewrite `_include/need_improvement.txt` as a native MyST admonition
(`:::{admonition} Call for Contributions / :class: error / ... / :::`)
and drop the now-unnecessary `{eval-rst}` wrapper at the single callsite
(`configuration/highavailability/index.md`) that wrapped the include for
RST processing.
The fix is companion to 9c815d68 (cmdincludemd RST plumbing) but targets
the plain-`{include}` path which doesn't route through our custom
extension.
🤖 Generated by [robots](https://vyos.io)
(cherry picked from commit 82a06e1dc812ceba239aaabf4acd651a038bfee7)
Diffstat (limited to 'docs/_static/css/code-snippets.css')
0 files changed, 0 insertions, 0 deletions
