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/_include | |
| 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/_include')
| -rw-r--r-- | docs/_include/need_improvement.txt | 22 |
1 files changed, 4 insertions, 18 deletions
diff --git a/docs/_include/need_improvement.txt b/docs/_include/need_improvement.txt index e368ee95..c95260ee 100644 --- a/docs/_include/need_improvement.txt +++ b/docs/_include/need_improvement.txt @@ -1,21 +1,7 @@ -.. raw:: latex - - \iffalse - -.. raw:: html - - <div class="admonition error"> - <p class="admonition-title">Call for Contributions</p> - +:::{admonition} Call for Contributions +:class: error Help improve this section with additional content, examples, and explanations. -For contribution guidelines, see :ref:`documentation`. - -.. raw:: html - - </div> - -.. raw:: latex - - \fi
\ No newline at end of file +For contribution guidelines, see {ref}`documentation`. +::: |