From 82a06e1dc812ceba239aaabf4acd651a038bfee7 Mon Sep 17 00:00:00 2001 From: Yuriy Andamasov Date: Wed, 13 May 2026 23:18:29 +0300 Subject: fix(includes): rewrite need_improvement.txt as MyST so plain `{include}` renders correctly MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- docs/configuration/highavailability/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) (limited to 'docs/configuration') diff --git a/docs/configuration/highavailability/index.md b/docs/configuration/highavailability/index.md index e26f5791..dbd36f03 100644 --- a/docs/configuration/highavailability/index.md +++ b/docs/configuration/highavailability/index.md @@ -414,8 +414,7 @@ To know more about scripting, check the {ref}`command-scripting` section. ## Virtual-server -```{eval-rst} -.. include:: /_include/need_improvement.txt +```{include} /_include/need_improvement.txt ``` Virtual Server allows to Load-balance traffic destination virtual-address:port -- cgit v1.2.3