3 files changed, 25 insertions, 13 deletions
diff --git a/Documentation/technotes/asan.md b/Documentation/technotes/asan.md
index e0d503a2a2..fedb63333a 100644
--- a/Documentation/technotes/asan.md
+++ b/Documentation/technotes/asan.md
@@ -207,7 +207,7 @@ Voilà! We just caught the memory bug using ASan.
 
 ## Supported platforms
 Presently, the following architectures support ASan in ramstage:
-```eval_rst
+```{eval-rst}
 +------------------+--------------------------------+
 | Architecture     | Notes                          |
 +==================+================================+
@@ -216,7 +216,7 @@ Presently, the following architectures support ASan in ramstage:
 ```
 
 And in romstage ASan is available on the following platforms:
-```eval_rst
+```{eval-rst}
 +---------------------+-----------------------------+
 | Platform            | Notes                       |
 +=====================+=============================+
diff --git a/Documentation/technotes/console.md b/Documentation/technotes/console.md
index 52de812f12..1b022a2b42 100644
--- a/Documentation/technotes/console.md
+++ b/Documentation/technotes/console.md
@@ -22,7 +22,7 @@ those SMBus pins. Some mainboard have SMBus pins in the PCIe slot as
 well.
 
 This feature has been tested on the following platforms:
-```eval_rst
+```{eval-rst}
 +------------------------------------+
 | Tested platforms                   |
 +====================================+
@@ -57,10 +57,18 @@ chip, you can enable the `SC16IS7XX_INIT` option to initialize the chip.
 
 If not we can use other I2C slave devices like an Arduino or a
 Beagleboard.
-* [Linux I2C Slave interface](https://web.archive.org/web/20220926173943/https://www.kernel.org/doc/html/latest/i2c/slave-interface.html)
-* [BeagleBone Black I2C Slave](https://web.archive.org/web/20220926171211/https://forum.beagleboard.org/t/beaglebone-black-and-arduino-uno-i2c-communication-using-c/29990/8)
+```{toctree}
+:maxdepth: 1
+
+Linux I2C Slave interface <https://web.archive.org/web/20220926173943/https://www.kernel.org/doc/html/latest/i2c/slave-interface.html>
+BeagleBone Black I2C Slave <https://web.archive.org/web/20220926171211/https://forum.beagleboard.org/t/beaglebone-black-and-arduino-uno-i2c-communication-using-c/29990/8>
+```
 
 This feature was added as part of a GSoC 2022 project. Checkout the
 following blog posts for more details.
-* [coreboot Console via SMBus — Part I](https://medium.com/@husnifaiz/coreboot-console-via-smbus-introduction-38273691a8ac)
-* [coreboot Console via SMBus — Part II](https://medium.com/@husnifaiz/coreboot-console-via-smbus-part-ii-bc324fdd2f24)
+```{toctree}
+:maxdepth: 1
+
+coreboot Console via SMBus — Part I <https://medium.com/@husnifaiz/coreboot-console-via-smbus-introduction-38273691a8ac>
+coreboot Console via SMBus — Part II <https://medium.com/@husnifaiz/coreboot-console-via-smbus-part-ii-bc324fdd2f24>
+```
diff --git a/Documentation/technotes/index.md b/Documentation/technotes/index.md
index da5b8644d2..e57519f336 100644
--- a/Documentation/technotes/index.md
+++ b/Documentation/technotes/index.md
@@ -1,8 +1,12 @@
 # Technotes
 
-* [Dealing with Untrusted Input in SMM](2017-02-dealing-with-untrusted-input-in-smm.md)
-* [Rebuilding coreboot image generation](2015-11-rebuilding-coreboot-image-generation.md)
-* [Unit testing coreboot](2020-03-unit-testing-coreboot.md)
-* [Unit Test Code Coverage](2021-05-code-coverage.md)
-* [Address Sanitizer](asan.md)
-* [coreboot Consoles](console.md)
+```{toctree}
+:maxdepth: 1
+
+Dealing with Untrusted Input in SMM <2017-02-dealing-with-untrusted-input-in-smm.md>
+Rebuilding coreboot image generation <2015-11-rebuilding-coreboot-image-generation.md>
+Unit testing coreboot <2020-03-unit-testing-coreboot.md>
+Unit Test Code Coverage <2021-05-code-coverage.md>
+Address Sanitizer <asan.md>
+coreboot Consoles <console.md>
+```