[doc] Rewrite most frontmatters to Markdown titles
Completely throw away the frontmatter and only keep the title which is
turned into a Markdown title.
To recreate the rewrite, run the added script,
`util/rewrite_frontmatter.py`, in the root of the repo.
```sh
python3 util/rewrite_frontmatter.py ./
```
Signed-off-by: Hugo McNally <hugo.mcnally@gmail.com>
Co-authored-by: Amaury Pouly <amaury.pouly@lowrisc.org>
diff --git a/sw/device/README.md b/sw/device/README.md
index b152f68..3f9fb54 100644
--- a/sw/device/README.md
+++ b/sw/device/README.md
@@ -1,6 +1,4 @@
----
-title: "Device Software"
----
+# Device Software
## Reference Firmware Images
diff --git a/sw/device/lib/README.md b/sw/device/lib/README.md
index 81292f8..16e046d 100644
--- a/sw/device/lib/README.md
+++ b/sw/device/lib/README.md
@@ -1,6 +1,4 @@
----
-title: "Device Libraries"
----
+# Device Libraries
## Overview
diff --git a/sw/device/lib/dif/README.md b/sw/device/lib/dif/README.md
index 95290c1..e340677 100644
--- a/sw/device/lib/dif/README.md
+++ b/sw/device/lib/dif/README.md
@@ -1,6 +1,4 @@
----
-title: "The OpenTitan DIF Library"
----
+# The OpenTitan DIF Library
A DIF is a "Device Interface Function". DIFs are low-level routines for
accessing the hardware functionality directly, and are agnostic to the
diff --git a/sw/device/lib/dif/dif_adc_ctrl.md b/sw/device/lib/dif/dif_adc_ctrl.md
index 91a3930..8802dc7 100644
--- a/sw/device/lib/dif/dif_adc_ctrl.md
+++ b/sw/device/lib/dif/dif_adc_ctrl.md
@@ -1,6 +1,4 @@
----
-title: "ADC Controller DIF Checklist"
----
+# ADC Controller DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [ADC Controller DIF](../../../../hw/ip/adc_ctrl/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_aes.md b/sw/device/lib/dif/dif_aes.md
index de291ed..d8b2a51 100644
--- a/sw/device/lib/dif/dif_aes.md
+++ b/sw/device/lib/dif/dif_aes.md
@@ -1,6 +1,4 @@
----
-title: "AES DIF Checklist"
----
+# AES DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [AES DIF](../../../../hw/ip/aes/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_alert_handler.md b/sw/device/lib/dif/dif_alert_handler.md
index f48daeb..b71301b 100644
--- a/sw/device/lib/dif/dif_alert_handler.md
+++ b/sw/device/lib/dif/dif_alert_handler.md
@@ -1,6 +1,4 @@
----
-title: "Alert Handler DIF Checklist"
----
+# Alert Handler DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Alert Handler DIF](../../../../hw/top_earlgrey/ip_autogen/alert_handler/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_aon_timer.md b/sw/device/lib/dif/dif_aon_timer.md
index ad368e4..f1331c8 100644
--- a/sw/device/lib/dif/dif_aon_timer.md
+++ b/sw/device/lib/dif/dif_aon_timer.md
@@ -1,6 +1,4 @@
----
-title: "Always-On Timer DIF Checklist"
----
+# Always-On Timer DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Always-On Timer DIF](../../../../hw/ip/aon_timer/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_clkmgr.md b/sw/device/lib/dif/dif_clkmgr.md
index 6fb6346..b0e01de 100644
--- a/sw/device/lib/dif/dif_clkmgr.md
+++ b/sw/device/lib/dif/dif_clkmgr.md
@@ -1,6 +1,4 @@
----
-title: "Clock Manager DIF Checklist"
----
+# Clock Manager DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Clock Manager DIF](../../../../hw/ip/clkmgr/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_csrng.md b/sw/device/lib/dif/dif_csrng.md
index 650e082..4c887bb 100644
--- a/sw/device/lib/dif/dif_csrng.md
+++ b/sw/device/lib/dif/dif_csrng.md
@@ -1,6 +1,4 @@
----
-title: "CSRNG DIF Checklist"
----
+# CSRNG DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [CSRNG DIF](../../../../hw/ip/csrng/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_edn.md b/sw/device/lib/dif/dif_edn.md
index 09867a1..2fb6e96 100644
--- a/sw/device/lib/dif/dif_edn.md
+++ b/sw/device/lib/dif/dif_edn.md
@@ -1,6 +1,4 @@
----
-title: "Entropy Distribution Network DIF Checklist"
----
+# Entropy Distribution Network DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Entropy Distribution Network DIF](../../../../hw/ip/edn/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_entropy_src.md b/sw/device/lib/dif/dif_entropy_src.md
index 1367d88..afedf37 100644
--- a/sw/device/lib/dif/dif_entropy_src.md
+++ b/sw/device/lib/dif/dif_entropy_src.md
@@ -1,6 +1,4 @@
----
-title: "Entropy Source DIF Checklist"
----
+# Entropy Source DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Entropy Source DIF](../../../../hw/ip/entropy_src/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_flash_ctrl.md b/sw/device/lib/dif/dif_flash_ctrl.md
index 0cd8da2..362fff1 100644
--- a/sw/device/lib/dif/dif_flash_ctrl.md
+++ b/sw/device/lib/dif/dif_flash_ctrl.md
@@ -1,6 +1,4 @@
----
-title: "Flash Controller DIF Checklist"
----
+# Flash Controller DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Flash Controller DIF](../../../../hw/ip/flash_ctrl/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_gpio.md b/sw/device/lib/dif/dif_gpio.md
index d023030..588e691 100644
--- a/sw/device/lib/dif/dif_gpio.md
+++ b/sw/device/lib/dif/dif_gpio.md
@@ -1,6 +1,4 @@
----
-title: "GPIO DIF Checklist"
----
+# GPIO DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [GPIO DIF](../../../../hw/ip/gpio/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_hmac.md b/sw/device/lib/dif/dif_hmac.md
index 6b0480e..2fe9661 100644
--- a/sw/device/lib/dif/dif_hmac.md
+++ b/sw/device/lib/dif/dif_hmac.md
@@ -1,6 +1,4 @@
----
-title: "HMAC DIF Checklist"
----
+# HMAC DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [HMAC DIF](../../../../hw/ip/hmac/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_i2c.md b/sw/device/lib/dif/dif_i2c.md
index 8977800..6181bf1 100644
--- a/sw/device/lib/dif/dif_i2c.md
+++ b/sw/device/lib/dif/dif_i2c.md
@@ -1,6 +1,4 @@
----
-title: "I2C DIF Checklist"
----
+# I2C DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [I2C DIF](../../../../hw/ip/i2c/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_keymgr.md b/sw/device/lib/dif/dif_keymgr.md
index af93d25..625af17 100644
--- a/sw/device/lib/dif/dif_keymgr.md
+++ b/sw/device/lib/dif/dif_keymgr.md
@@ -1,6 +1,4 @@
----
-title: "Key Manager DIF Checklist"
----
+# Key Manager DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Key Manager DIF](../../../../hw/ip/keymgr/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_kmac.md b/sw/device/lib/dif/dif_kmac.md
index 12cacfb..99dad27 100644
--- a/sw/device/lib/dif/dif_kmac.md
+++ b/sw/device/lib/dif/dif_kmac.md
@@ -1,6 +1,4 @@
----
-title: "KMAC DIF Checklist"
----
+# KMAC DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [KMAC DIF](../../../../hw/ip/kmac/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_lc_ctrl.md b/sw/device/lib/dif/dif_lc_ctrl.md
index 4ede965..84ed4aa 100644
--- a/sw/device/lib/dif/dif_lc_ctrl.md
+++ b/sw/device/lib/dif/dif_lc_ctrl.md
@@ -1,6 +1,4 @@
----
-title: "Lifecycle Controller DIF Checklist"
----
+# Lifecycle Controller DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Lifecycle Controller DIF](../../../../hw/ip/lc_ctrl/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_otbn.md b/sw/device/lib/dif/dif_otbn.md
index 0093c6f..f627e1f 100644
--- a/sw/device/lib/dif/dif_otbn.md
+++ b/sw/device/lib/dif/dif_otbn.md
@@ -1,6 +1,4 @@
----
-title: "OTBN DIF Checklist"
----
+# OTBN DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [OTBN DIF](../../../../hw/ip/otbn/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_otp_ctrl.md b/sw/device/lib/dif/dif_otp_ctrl.md
index 51ce7f3..4a2b2cd 100644
--- a/sw/device/lib/dif/dif_otp_ctrl.md
+++ b/sw/device/lib/dif/dif_otp_ctrl.md
@@ -1,6 +1,4 @@
----
-title: "OTP Controller DIF Checklist"
----
+# OTP Controller DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [OTP Controller DIF](../../../../hw/ip/otp_ctrl/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_pattgen.md b/sw/device/lib/dif/dif_pattgen.md
index 3f74bc4..75b219f 100644
--- a/sw/device/lib/dif/dif_pattgen.md
+++ b/sw/device/lib/dif/dif_pattgen.md
@@ -1,6 +1,4 @@
----
-title: "Pattern Generator DIF Checklist"
----
+# Pattern Generator DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Pattern Generator DIF](../../../../hw/ip/pattgen/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_pinmux.md b/sw/device/lib/dif/dif_pinmux.md
index 6440f06..b4746b9 100644
--- a/sw/device/lib/dif/dif_pinmux.md
+++ b/sw/device/lib/dif/dif_pinmux.md
@@ -1,6 +1,4 @@
----
-title: "Pin Multiplexer DIF Checklist"
----
+# Pin Multiplexer DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Pin Multiplexer DIF](../../../../hw/ip/pinmux/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_pwm.md b/sw/device/lib/dif/dif_pwm.md
index f911d0b..606cec4 100644
--- a/sw/device/lib/dif/dif_pwm.md
+++ b/sw/device/lib/dif/dif_pwm.md
@@ -1,6 +1,4 @@
----
-title: "PWM DIF Checklist"
----
+# PWM DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [PWM DIF](../../../../hw/ip/pwm/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_pwrmgr.md b/sw/device/lib/dif/dif_pwrmgr.md
index 51b60df..1828c86 100644
--- a/sw/device/lib/dif/dif_pwrmgr.md
+++ b/sw/device/lib/dif/dif_pwrmgr.md
@@ -1,6 +1,4 @@
----
-title: "Power Manager DIF Checklist"
----
+# Power Manager DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Power Manager DIF](../../../../hw/ip/pwrmgr/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_rom_ctrl.md b/sw/device/lib/dif/dif_rom_ctrl.md
index e585d7f..bb75af5 100644
--- a/sw/device/lib/dif/dif_rom_ctrl.md
+++ b/sw/device/lib/dif/dif_rom_ctrl.md
@@ -1,6 +1,4 @@
----
-title: "ROM Controller DIF Checklist"
----
+# ROM Controller DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [ROM Controller DIF](../../../../hw/ip/rom_ctrl/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_rstmgr.md b/sw/device/lib/dif/dif_rstmgr.md
index d58ddda..1e7a0ef 100644
--- a/sw/device/lib/dif/dif_rstmgr.md
+++ b/sw/device/lib/dif/dif_rstmgr.md
@@ -1,6 +1,4 @@
----
-title: "Reset Manager DIF Checklist"
----
+# Reset Manager DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Reset Manager DIF](../../../../hw/ip/rstmgr/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_rv_core_ibex.md b/sw/device/lib/dif/dif_rv_core_ibex.md
index d8d3b22..72666c8 100644
--- a/sw/device/lib/dif/dif_rv_core_ibex.md
+++ b/sw/device/lib/dif/dif_rv_core_ibex.md
@@ -1,6 +1,4 @@
----
-title: "Rv core ibex DIF Checklist"
----
+# Rv core ibex DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Rv core ibex DIF](../../../../hw/ip/rv_core_ibex/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_rv_plic.md b/sw/device/lib/dif/dif_rv_plic.md
index 3923d29..9ebad2a 100644
--- a/sw/device/lib/dif/dif_rv_plic.md
+++ b/sw/device/lib/dif/dif_rv_plic.md
@@ -1,6 +1,4 @@
----
-title: "PLIC DIF Checklist"
----
+# PLIC DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [PLIC DIF](../../../../hw/top_earlgrey/ip_autogen/rv_plic/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_rv_timer.md b/sw/device/lib/dif/dif_rv_timer.md
index d527ad4..17a3d4a 100644
--- a/sw/device/lib/dif/dif_rv_timer.md
+++ b/sw/device/lib/dif/dif_rv_timer.md
@@ -1,6 +1,4 @@
----
-title: "RV Timer DIF Checklist"
----
+# RV Timer DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [RV Timer DIF](../../../../hw/ip/rv_timer/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_sensor_ctrl.md b/sw/device/lib/dif/dif_sensor_ctrl.md
index 0aaf497..601eb0e 100644
--- a/sw/device/lib/dif/dif_sensor_ctrl.md
+++ b/sw/device/lib/dif/dif_sensor_ctrl.md
@@ -1,6 +1,4 @@
----
-title: "Sensor Controller DIF Checklist"
----
+# Sensor Controller DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Sensor Controller DIF](../../../../hw/top_earlgrey/ip/sensor_ctrl/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_spi_device.md b/sw/device/lib/dif/dif_spi_device.md
index 3a6d07a..f064da5 100644
--- a/sw/device/lib/dif/dif_spi_device.md
+++ b/sw/device/lib/dif/dif_spi_device.md
@@ -1,6 +1,4 @@
----
-title: "SPI Device DIF Checklist"
----
+# SPI Device DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [SPI Device DIF](../../../../hw/ip/spi_device/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_spi_host.md b/sw/device/lib/dif/dif_spi_host.md
index d1f4429..dc40c06 100644
--- a/sw/device/lib/dif/dif_spi_host.md
+++ b/sw/device/lib/dif/dif_spi_host.md
@@ -1,6 +1,4 @@
----
-title: "SPI Host DIF Checklist"
----
+# SPI Host DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [SPI Host DIF](../../../../hw/ip/spi_host/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_sram_ctrl.md b/sw/device/lib/dif/dif_sram_ctrl.md
index 2bf014d..728045e 100644
--- a/sw/device/lib/dif/dif_sram_ctrl.md
+++ b/sw/device/lib/dif/dif_sram_ctrl.md
@@ -1,6 +1,4 @@
----
-title: "SRAM Controller DIF Checklist"
----
+# SRAM Controller DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [SRAM Controller DIF](../../../../hw/ip/sram_ctrl/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_sysrst_ctrl.md b/sw/device/lib/dif/dif_sysrst_ctrl.md
index 51e70ad..fc6a490 100644
--- a/sw/device/lib/dif/dif_sysrst_ctrl.md
+++ b/sw/device/lib/dif/dif_sysrst_ctrl.md
@@ -1,6 +1,4 @@
----
-title: "System Reset Controller DIF Checklist"
----
+# System Reset Controller DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [System Reset Controller DIF](../../../../hw/ip/sysrst_ctrl/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_uart.md b/sw/device/lib/dif/dif_uart.md
index 612f689..92ed03e 100644
--- a/sw/device/lib/dif/dif_uart.md
+++ b/sw/device/lib/dif/dif_uart.md
@@ -1,6 +1,4 @@
----
-title: "UART DIF Checklist"
----
+# UART DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [UART DIF](../../../../hw/ip/uart/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/dif/dif_usbdev.md b/sw/device/lib/dif/dif_usbdev.md
index 7910277..0e5f851 100644
--- a/sw/device/lib/dif/dif_usbdev.md
+++ b/sw/device/lib/dif/dif_usbdev.md
@@ -1,6 +1,4 @@
----
-title: "USB Device DIF Checklist"
----
+# USB Device DIF Checklist
This checklist is for [Development Stage](../../../../doc/project_governance/development_stages.md) transitions for the [USB Device DIF](../../../../hw/ip/usbdev/README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/sw/device/lib/testing/README.md b/sw/device/lib/testing/README.md
index 65e3d49..1d041e6 100644
--- a/sw/device/lib/testing/README.md
+++ b/sw/device/lib/testing/README.md
@@ -1,6 +1,4 @@
----
-title: "Chip-Level Test Libraries"
----
+# Chip-Level Test Libraries
# Overview
diff --git a/sw/device/lib/testing/test_framework/README.md b/sw/device/lib/testing/test_framework/README.md
index 754cf78..79e5514 100644
--- a/sw/device/lib/testing/test_framework/README.md
+++ b/sw/device/lib/testing/test_framework/README.md
@@ -1,6 +1,4 @@
----
-title: "On-Device Test Framework"
----
+# On-Device Test Framework
# Overview
diff --git a/sw/device/silicon_creator/README.md b/sw/device/silicon_creator/README.md
index 9b1d0e5..180eae3 100644
--- a/sw/device/silicon_creator/README.md
+++ b/sw/device/silicon_creator/README.md
@@ -1,6 +1,4 @@
----
-title: "Silicon Creator Software"
----
+# Silicon Creator Software
## Documentation Index
diff --git a/sw/device/silicon_creator/manuf/README.md b/sw/device/silicon_creator/manuf/README.md
index 3f71192..24e4129 100644
--- a/sw/device/silicon_creator/manuf/README.md
+++ b/sw/device/silicon_creator/manuf/README.md
@@ -1,6 +1,4 @@
----
-title: Manufacturing Firmware
----
+# Manufacturing Firmware
## Testplan
diff --git a/sw/device/silicon_creator/rom/README.md b/sw/device/silicon_creator/rom/README.md
index 394e740..b38de3d 100644
--- a/sw/device/silicon_creator/rom/README.md
+++ b/sw/device/silicon_creator/rom/README.md
@@ -1,6 +1,4 @@
----
-title: "ROM"
----
+# ROM
<p style="color: red; text-align: right;">
Status: Draft
diff --git a/sw/device/silicon_creator/rom/doc/memory_protection.md b/sw/device/silicon_creator/rom/doc/memory_protection.md
index dade04a..1787a2a 100644
--- a/sw/device/silicon_creator/rom/doc/memory_protection.md
+++ b/sw/device/silicon_creator/rom/doc/memory_protection.md
@@ -1,6 +1,4 @@
----
-title: "Memory Protection Module"
----
+# Memory Protection Module
<p style="color: red; text-align: right;">
Status: Draft
diff --git a/sw/device/silicon_creator/rom/keys/README.md b/sw/device/silicon_creator/rom/keys/README.md
index 80f0599..eb28980 100644
--- a/sw/device/silicon_creator/rom/keys/README.md
+++ b/sw/device/silicon_creator/rom/keys/README.md
@@ -1,6 +1,4 @@
----
-title: "Signing Keys"
----
+# Signing Keys
This directory contains ASN1 DER encoded development keys for signing ROM\_EXT
images. Until we have a more ergonomic tool for working with keys and signatures,
diff --git a/sw/device/silicon_creator/rom_ext/doc/manifest.md b/sw/device/silicon_creator/rom_ext/doc/manifest.md
index 489df9f..12958f2 100644
--- a/sw/device/silicon_creator/rom_ext/doc/manifest.md
+++ b/sw/device/silicon_creator/rom_ext/doc/manifest.md
@@ -1,8 +1,4 @@
----
-title: Manifest Format
-aliases:
-- /sw/device/silicon_creator/manifest
----
+# Manifest Format
<p style="color: red; text-align: right;">
Status: Draft
diff --git a/sw/device/tests/README.md b/sw/device/tests/README.md
index c378b60..9dd98f1 100644
--- a/sw/device/tests/README.md
+++ b/sw/device/tests/README.md
@@ -1,6 +1,4 @@
----
-title: "Chip-Level Tests"
----
+# Chip-Level Tests
# Overview
