From 873a388fdb5faeb869881cc780de16c96385e433 Mon Sep 17 00:00:00 2001
From: LiudmylaNad <l.nadolina@vyos.io>
Date: Tue, 4 Aug 2026 11:54:54 +0200
Subject: docs: fix MyST roles used inside eval-rst blocks (#2125)

* docs: fix MyST roles used inside eval-rst blocks

* Apply suggestions from code review

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 docs/index.md | 40 ++++++++++++++++++++++++++--------------
 1 file changed, 26 insertions(+), 14 deletions(-)

(limited to 'docs/index.md')

diff --git a/docs/index.md b/docs/index.md
index 499a4926..65858eea 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -9,43 +9,55 @@
    .. grid-item-card:: Get / Build VyOS
 
 
-      Quickly {ref}`Build<contributing/build-vyos:build vyos>` your own Image or take a look at how to {ref}`download<installation/install:download>` a free or supported version.
+      Quickly :ref:`Build <contributing/build-vyos:build vyos>` your own
+      Image or take a look at how to
+      :ref:`download <installation/install:download>` a free or supported
+      version.
 
 
    .. grid-item-card:: Install VyOS
 
-      Read about how to install VyOS on {ref}`Bare Metal<installation/install:installation>` or in a
-      {ref}`Virtual Environment<installation/virtual/index:running vyos in virtual environments>` and
-      how to use an image with the usual {ref}`cloud<installation/cloud/index:running VyOS in Cloud Environments>` providers
+      Read about how to install VyOS on
+      :ref:`Bare Metal <installation/install:installation>` or in a
+      :ref:`Virtual Environment <installation/virtual/index:running vyos in virtual environments>`
+      and how to use an image with the usual
+      :ref:`cloud <installation/cloud/index:running VyOS in Cloud Environments>`
+      providers
 
 
    .. grid-item-card:: Configuration and Operation
 
-      Use the {ref}`Quickstart Guide<quick-start:Quick Start>`, to have a fast overview. Or go deeper and
-      set up {ref}`advanced routing<configuration/protocols/index:protocols>`,
-      {ref}`VRFs<configuration/vrf/index:vrf>`, or
-      {ref}`VPNs<configuration/vpn/index:vpn>` for example.
+      Use the :ref:`Quickstart Guide <quick-start:Quick Start>`, to have a
+      fast overview. Or go deeper and
+      set up :ref:`advanced routing <configuration/protocols/index:protocols>`,
+      :ref:`VRFs <configuration/vrf/index:vrf>`, or
+      :ref:`VPNs <configuration/vpn/index:vpn>` for example.
 
 
    .. grid-item-card:: Automate
 
       Integrate VyOS in your automation Workflow with
-      {ref}`Ansible<vyos-ansible>`,
-      have your own {ref}`local scripts<command-scripting>`, or configure VyOS with the {ref}`HTTPS-API<vyosapi>`.
+      :ref:`Ansible <vyos-ansible>`,
+      have your own :ref:`local scripts <command-scripting>`, or configure
+      VyOS with the :ref:`HTTPS-API <vyosapi>`.
 
 
    .. grid-item-card::  Examples
 
-      Get some inspiration from the {ref}`Configuration Blueprints<configexamples/index:Configuration Blueprints>`
+      Get some inspiration from the
+      :ref:`configexamples/index:Configuration Blueprints`
       to build your infrastructure.
 
 
    .. grid-item-card:: Contribute and Community
 
       | There are many ways to contribute to the project.
-      | Add missing parts or improve the {ref}`Documentation<documentation:Write Documentation>`.
-      | Discuss in `Slack <https://slack.vyos.io/>`_ or the `Forum <https://forum.vyos.io>`_.
-      | Or you can pick up a `Task <https://vyos.dev/>`_ and fix the {ref}`code<contributing/development:development>`.
+      | Add missing parts or improve the
+        :ref:`Documentation <documentation:Write Documentation>`.
+      | Discuss in `Slack <https://slack.vyos.io/>`_ or the
+        `Forum <https://forum.vyos.io>`_.
+      | Or you can pick up a `Task <https://vyos.dev/>`_ and fix the
+        :ref:`code <contributing/development:development>`.
 
 ```
 
-- 
cgit v1.2.3