[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/hw/ip/README.md b/hw/ip/README.md
index ad34257..5ea7d6d 100644
--- a/hw/ip/README.md
+++ b/hw/ip/README.md
@@ -1,5 +1,3 @@
----
-title: "IP cores"
----
+# IP cores
{{% sectionContent type="section" depth="1" %}}
diff --git a/hw/ip/adc_ctrl/README.md b/hw/ip/adc_ctrl/README.md
index 6e4938d..aff9d8a 100644
--- a/hw/ip/adc_ctrl/README.md
+++ b/hw/ip/adc_ctrl/README.md
@@ -1,6 +1,4 @@
----
-title: "Analog to Digital Converter Control Interface"
----
+# Analog to Digital Converter Control Interface
# Overview
diff --git a/hw/ip/adc_ctrl/doc/checklist.md b/hw/ip/adc_ctrl/doc/checklist.md
index 330314f..00ebfce 100644
--- a/hw/ip/adc_ctrl/doc/checklist.md
+++ b/hw/ip/adc_ctrl/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "ADC_CTRL Checklist"
----
+# ADC_CTRL Checklist
<!--
NOTE: This is a template checklist document that is required to be copied over to the 'doc'
diff --git a/hw/ip/adc_ctrl/dv/README.md b/hw/ip/adc_ctrl/dv/README.md
index 8936421..376b677 100644
--- a/hw/ip/adc_ctrl/dv/README.md
+++ b/hw/ip/adc_ctrl/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "ADC_CTRL DV document"
----
+# ADC_CTRL DV document
## Goals
* **DV**
diff --git a/hw/ip/aes/README.md b/hw/ip/aes/README.md
index 84e53c2..798e32e 100644
--- a/hw/ip/aes/README.md
+++ b/hw/ip/aes/README.md
@@ -1,6 +1,4 @@
----
-title: "AES HWIP Technical Specification"
----
+# AES HWIP Technical Specification
# Overview
diff --git a/hw/ip/aes/doc/checklist.md b/hw/ip/aes/doc/checklist.md
index 7af1138..c97ad99 100644
--- a/hw/ip/aes/doc/checklist.md
+++ b/hw/ip/aes/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "AES Checklist"
----
+# AES Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [AES peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/aes/dv/README.md b/hw/ip/aes/dv/README.md
index d276bb9..f09b85a 100644
--- a/hw/ip/aes/dv/README.md
+++ b/hw/ip/aes/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "AES DV document"
----
+# AES DV document
## Goals
* **DV**
diff --git a/hw/ip/aon_timer/README.md b/hw/ip/aon_timer/README.md
index 704898d..5f84d17 100644
--- a/hw/ip/aon_timer/README.md
+++ b/hw/ip/aon_timer/README.md
@@ -1,6 +1,4 @@
----
-title: "AON Timer Technical Specification"
----
+# AON Timer Technical Specification
# Overview
diff --git a/hw/ip/aon_timer/doc/checklist.md b/hw/ip/aon_timer/doc/checklist.md
index 1e23e62..eaaeab0 100644
--- a/hw/ip/aon_timer/doc/checklist.md
+++ b/hw/ip/aon_timer/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "AON Timer Checklist"
----
+# AON Timer Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [AON Timer peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/aon_timer/dv/README.md b/hw/ip/aon_timer/dv/README.md
index d56cafa..0b64dd3 100644
--- a/hw/ip/aon_timer/dv/README.md
+++ b/hw/ip/aon_timer/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "AON Timer DV Document"
----
+# AON Timer DV Document
## Goals
* **DV**
diff --git a/hw/ip/clkmgr/README.md b/hw/ip/clkmgr/README.md
index eda0a5c..0be9f13 100644
--- a/hw/ip/clkmgr/README.md
+++ b/hw/ip/clkmgr/README.md
@@ -1,6 +1,4 @@
----
-title: "Clock Manager HWIP Technical Specification"
----
+# Clock Manager HWIP Technical Specification
# Overview
diff --git a/hw/ip/clkmgr/doc/checklist.md b/hw/ip/clkmgr/doc/checklist.md
index f0bcfa4..c8c4a36 100644
--- a/hw/ip/clkmgr/doc/checklist.md
+++ b/hw/ip/clkmgr/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "CLKMGR Checklist"
----
+# CLKMGR Checklist
<!--
NOTE: This is a template checklist document that is required to be copied over to the 'doc'
diff --git a/hw/ip/clkmgr/dv/README.md b/hw/ip/clkmgr/dv/README.md
index 298916a..8b97b81 100644
--- a/hw/ip/clkmgr/dv/README.md
+++ b/hw/ip/clkmgr/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "CLKMGR DV document"
----
+# CLKMGR DV document
## Goals
* **DV**
diff --git a/hw/ip/csrng/README.md b/hw/ip/csrng/README.md
index f47415d..9574a60 100644
--- a/hw/ip/csrng/README.md
+++ b/hw/ip/csrng/README.md
@@ -1,6 +1,4 @@
----
-title: "CSRNG HWIP Technical Specification"
----
+# CSRNG HWIP Technical Specification
# Overview
diff --git a/hw/ip/csrng/doc/checklist.md b/hw/ip/csrng/doc/checklist.md
index d501811..de175c1 100644
--- a/hw/ip/csrng/doc/checklist.md
+++ b/hw/ip/csrng/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "CSRNG Checklist"
----
+# CSRNG Checklist
<!--
NOTE: This is a template checklist document that is required to be copied over to the 'doc'
diff --git a/hw/ip/csrng/dv/README.md b/hw/ip/csrng/dv/README.md
index d29adf1..8b466a5 100644
--- a/hw/ip/csrng/dv/README.md
+++ b/hw/ip/csrng/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "CSRNG DV document"
----
+# CSRNG DV document
## Goals
* **DV**
diff --git a/hw/ip/edn/README.md b/hw/ip/edn/README.md
index bbae574..28efd8d 100644
--- a/hw/ip/edn/README.md
+++ b/hw/ip/edn/README.md
@@ -1,6 +1,4 @@
----
-title: "EDN HWIP Technical Specification"
----
+# EDN HWIP Technical Specification
# Overview
diff --git a/hw/ip/edn/doc/checklist.md b/hw/ip/edn/doc/checklist.md
index 4b84be3..6526cf6 100644
--- a/hw/ip/edn/doc/checklist.md
+++ b/hw/ip/edn/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "EDN Checklist"
----
+# EDN Checklist
<!--
NOTE: This is a template checklist document that is required to be copied over to the 'doc'
diff --git a/hw/ip/edn/dv/README.md b/hw/ip/edn/dv/README.md
index 37c1837..7143065 100644
--- a/hw/ip/edn/dv/README.md
+++ b/hw/ip/edn/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "EDN DV document"
----
+# EDN DV document
## Goals
* **DV**
diff --git a/hw/ip/entropy_src/README.md b/hw/ip/entropy_src/README.md
index 2c85a17..bf00dbd 100644
--- a/hw/ip/entropy_src/README.md
+++ b/hw/ip/entropy_src/README.md
@@ -1,6 +1,4 @@
----
-title: "ENTROPY_SRC HWIP Technical Specification"
----
+# ENTROPY_SRC HWIP Technical Specification
# Overview
diff --git a/hw/ip/entropy_src/doc/checklist.md b/hw/ip/entropy_src/doc/checklist.md
index bee6aa9..fff0906 100644
--- a/hw/ip/entropy_src/doc/checklist.md
+++ b/hw/ip/entropy_src/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "ENTROPY_SRC Checklist"
----
+# ENTROPY_SRC Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [ENTROPY_SRC peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/entropy_src/dv/README.md b/hw/ip/entropy_src/dv/README.md
index ac6bbe7..76715c0 100644
--- a/hw/ip/entropy_src/dv/README.md
+++ b/hw/ip/entropy_src/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "ENTROPY_SRC DV document"
----
+# ENTROPY_SRC DV document
## Goals
* **DV**
diff --git a/hw/ip/flash_ctrl/README.md b/hw/ip/flash_ctrl/README.md
index f780e8c..823d853 100644
--- a/hw/ip/flash_ctrl/README.md
+++ b/hw/ip/flash_ctrl/README.md
@@ -1,6 +1,4 @@
----
-title: "Flash Controller HWIP Technical Specification"
----
+# Flash Controller HWIP Technical Specification
# Overview
diff --git a/hw/ip/flash_ctrl/doc/checklist.md b/hw/ip/flash_ctrl/doc/checklist.md
index 46216bb..0f9712c 100644
--- a/hw/ip/flash_ctrl/doc/checklist.md
+++ b/hw/ip/flash_ctrl/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "FLASH_CTRL Checklist"
----
+# FLASH_CTRL Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [FLASH_CTRL peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/flash_ctrl/dv/README.md b/hw/ip/flash_ctrl/dv/README.md
index 9b76902..c312ed4 100644
--- a/hw/ip/flash_ctrl/dv/README.md
+++ b/hw/ip/flash_ctrl/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "FLASH_CTRL DV document"
----
+# FLASH_CTRL DV document
## Goals
* **DV**
diff --git a/hw/ip/gpio/README.md b/hw/ip/gpio/README.md
index 4301745..5e76c22 100644
--- a/hw/ip/gpio/README.md
+++ b/hw/ip/gpio/README.md
@@ -1,6 +1,4 @@
----
-title: "GPIO HWIP Technical Specification"
----
+# GPIO HWIP Technical Specification
# Overview
diff --git a/hw/ip/gpio/doc/checklist.md b/hw/ip/gpio/doc/checklist.md
index 9f564a2..36e8b7c 100644
--- a/hw/ip/gpio/doc/checklist.md
+++ b/hw/ip/gpio/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "GPIO Checklist"
----
+# GPIO Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [GPIO peripheral][GPIO Spec].
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/gpio/dv/README.md b/hw/ip/gpio/dv/README.md
index 834d6f9..86765dd 100644
--- a/hw/ip/gpio/dv/README.md
+++ b/hw/ip/gpio/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "GPIO DV document"
----
+# GPIO DV document
## Goals
* **DV**
diff --git a/hw/ip/hmac/README.md b/hw/ip/hmac/README.md
index 33c3c5a..4b8f6aa 100644
--- a/hw/ip/hmac/README.md
+++ b/hw/ip/hmac/README.md
@@ -1,6 +1,4 @@
----
-title: "HMAC HWIP Technical Specification"
----
+# HMAC HWIP Technical Specification
# Overview
diff --git a/hw/ip/hmac/doc/checklist.md b/hw/ip/hmac/doc/checklist.md
index 18ba03c..6ae8f08 100644
--- a/hw/ip/hmac/doc/checklist.md
+++ b/hw/ip/hmac/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "HMAC Checklist"
----
+# HMAC Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [HMAC peripheral](../README.md).
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/hmac/dv/README.md b/hw/ip/hmac/dv/README.md
index 85182cd..02d391c 100644
--- a/hw/ip/hmac/dv/README.md
+++ b/hw/ip/hmac/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "HMAC DV document"
----
+# HMAC DV document
## Goals
* **DV**
diff --git a/hw/ip/i2c/README.md b/hw/ip/i2c/README.md
index b8abfcd..493b57a 100644
--- a/hw/ip/i2c/README.md
+++ b/hw/ip/i2c/README.md
@@ -1,6 +1,4 @@
----
-title: "I2C HWIP Technical Specification"
----
+# I2C HWIP Technical Specification
# Overview
diff --git a/hw/ip/i2c/doc/checklist.md b/hw/ip/i2c/doc/checklist.md
index 1e56396..146901f 100644
--- a/hw/ip/i2c/doc/checklist.md
+++ b/hw/ip/i2c/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "I2C Checklist"
----
+# I2C Checklist
This checklist is for [Hardware Stage][] transitions for the [I2C peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/i2c/dv/README.md b/hw/ip/i2c/dv/README.md
index a1a7894..d964f73 100644
--- a/hw/ip/i2c/dv/README.md
+++ b/hw/ip/i2c/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "I2C DV document"
----
+# I2C DV document
## Goals
* **DV**
diff --git a/hw/ip/keymgr/README.md b/hw/ip/keymgr/README.md
index a9c2a0a..6687667 100644
--- a/hw/ip/keymgr/README.md
+++ b/hw/ip/keymgr/README.md
@@ -1,6 +1,4 @@
----
-title: "Key Manager HWIP Technical Specification"
----
+# Key Manager HWIP Technical Specification
# Overview
diff --git a/hw/ip/keymgr/doc/checklist.md b/hw/ip/keymgr/doc/checklist.md
index 7997759..c952165 100644
--- a/hw/ip/keymgr/doc/checklist.md
+++ b/hw/ip/keymgr/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "KEYMGR Checklist"
----
+# KEYMGR Checklist
<!--
NOTE: This is a template checklist document that is required to be copied over to the 'doc'
diff --git a/hw/ip/keymgr/dv/README.md b/hw/ip/keymgr/dv/README.md
index af5b3e2..bf3e6f4 100644
--- a/hw/ip/keymgr/dv/README.md
+++ b/hw/ip/keymgr/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "KEYMGR DV document"
----
+# KEYMGR DV document
## Goals
* **DV**
diff --git a/hw/ip/kmac/README.md b/hw/ip/kmac/README.md
index 946e4ce..c070405 100644
--- a/hw/ip/kmac/README.md
+++ b/hw/ip/kmac/README.md
@@ -1,6 +1,4 @@
----
-title: "KMAC HWIP Technical Specification"
----
+# KMAC HWIP Technical Specification
# Overview
diff --git a/hw/ip/kmac/doc/checklist.md b/hw/ip/kmac/doc/checklist.md
index fefdd4c..d774a08 100644
--- a/hw/ip/kmac/doc/checklist.md
+++ b/hw/ip/kmac/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "KMAC Checklist"
----
+# KMAC Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [KMAC peripheral](../README.md).
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/kmac/dv/README.md b/hw/ip/kmac/dv/README.md
index 774316b..536df27 100644
--- a/hw/ip/kmac/dv/README.md
+++ b/hw/ip/kmac/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "KMAC DV document"
----
+# KMAC DV document
## Goals
* **DV**
diff --git a/hw/ip/lc_ctrl/README.md b/hw/ip/lc_ctrl/README.md
index 4062914..4d507b4 100644
--- a/hw/ip/lc_ctrl/README.md
+++ b/hw/ip/lc_ctrl/README.md
@@ -1,6 +1,4 @@
----
-title: "Life Cycle Controller Technical Specification"
----
+# Life Cycle Controller Technical Specification
# Overview
diff --git a/hw/ip/lc_ctrl/doc/checklist.md b/hw/ip/lc_ctrl/doc/checklist.md
index 42fd7f4..e03383c 100644
--- a/hw/ip/lc_ctrl/doc/checklist.md
+++ b/hw/ip/lc_ctrl/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "LC_CTRL Checklist"
----
+# LC_CTRL Checklist
<!--
NOTE: This is a template checklist document that is required to be copied over to the 'doc'
diff --git a/hw/ip/lc_ctrl/dv/README.md b/hw/ip/lc_ctrl/dv/README.md
index 31acf28..fb40721 100644
--- a/hw/ip/lc_ctrl/dv/README.md
+++ b/hw/ip/lc_ctrl/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "LC_CTRL DV document"
----
+# LC_CTRL DV document
## Goals
* **DV**
diff --git a/hw/ip/otbn/README.md b/hw/ip/otbn/README.md
index 5a0eed8..5e923da 100644
--- a/hw/ip/otbn/README.md
+++ b/hw/ip/otbn/README.md
@@ -1,6 +1,4 @@
----
-title: OpenTitan Big Number Accelerator (OTBN) Technical Specification
----
+# OpenTitan Big Number Accelerator (OTBN) Technical Specification
# Overview
diff --git a/hw/ip/otbn/doc/checklist.md b/hw/ip/otbn/doc/checklist.md
index 48e9289..e158184 100644
--- a/hw/ip/otbn/doc/checklist.md
+++ b/hw/ip/otbn/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "OTBN Checklist"
----
+# OTBN Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [OTBN peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/otbn/doc/isa.md b/hw/ip/otbn/doc/isa.md
index 6b56fb8..8952e6b 100644
--- a/hw/ip/otbn/doc/isa.md
+++ b/hw/ip/otbn/doc/isa.md
@@ -1,6 +1,4 @@
----
-title: OpenTitan Big Number Accelerator (OTBN) Instruction Set Architecture
----
+# OpenTitan Big Number Accelerator (OTBN) Instruction Set Architecture
This document describes the instruction set for OTBN.
For more details about the processor itself, see the [OTBN Technical Specification](../README.md).
diff --git a/hw/ip/otbn/dv/README.md b/hw/ip/otbn/dv/README.md
index 64c098c..b1382da 100644
--- a/hw/ip/otbn/dv/README.md
+++ b/hw/ip/otbn/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "OTBN DV document"
----
+# OTBN DV document
## Goals
* **DV**
diff --git a/hw/ip/otbn/dv/doc/fcov.md b/hw/ip/otbn/dv/doc/fcov.md
index 5755b08..4a93d89 100644
--- a/hw/ip/otbn/dv/doc/fcov.md
+++ b/hw/ip/otbn/dv/doc/fcov.md
@@ -1,6 +1,4 @@
----
-title: "OTBN functional coverage"
----
+# OTBN functional coverage
We distinguish between *architectural* and *micro-architectural* functional coverage.
The idea is that the points that go into architectural coverage are those that a DV engineer could derive by reading the block specification.
diff --git a/hw/ip/otp_ctrl/README.md b/hw/ip/otp_ctrl/README.md
index f2c1e55..a9aa5e7 100644
--- a/hw/ip/otp_ctrl/README.md
+++ b/hw/ip/otp_ctrl/README.md
@@ -1,6 +1,4 @@
----
-title: "OTP Controller Technical Specification"
----
+# OTP Controller Technical Specification
# Overview
diff --git a/hw/ip/otp_ctrl/doc/checklist.md b/hw/ip/otp_ctrl/doc/checklist.md
index c8fd2e4..5554f23 100644
--- a/hw/ip/otp_ctrl/doc/checklist.md
+++ b/hw/ip/otp_ctrl/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "OTP_CTRL Checklist"
----
+# OTP_CTRL Checklist
<!--
NOTE: This is a template checklist document that is required to be copied over to the 'doc'
diff --git a/hw/ip/otp_ctrl/dv/README.md b/hw/ip/otp_ctrl/dv/README.md
index d7b127f..16db6bd 100644
--- a/hw/ip/otp_ctrl/dv/README.md
+++ b/hw/ip/otp_ctrl/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "OTP_CTRL DV document"
----
+# OTP_CTRL DV document
## Goals
* **DV**
diff --git a/hw/ip/pattgen/README.md b/hw/ip/pattgen/README.md
index 7e3cc9c..d2b9bcd 100644
--- a/hw/ip/pattgen/README.md
+++ b/hw/ip/pattgen/README.md
@@ -1,6 +1,4 @@
----
-title: "Pattern Generator HWIP Technical Specification"
----
+# Pattern Generator HWIP Technical Specification
# Overview
diff --git a/hw/ip/pattgen/doc/checklist.md b/hw/ip/pattgen/doc/checklist.md
index 5af0cea..ebcfc38 100644
--- a/hw/ip/pattgen/doc/checklist.md
+++ b/hw/ip/pattgen/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "Pattgen Checklist"
----
+# Pattgen Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Pattgen peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/pattgen/dv/README.md b/hw/ip/pattgen/dv/README.md
index 2662956..782e222 100644
--- a/hw/ip/pattgen/dv/README.md
+++ b/hw/ip/pattgen/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "PATTGEN DV document"
----
+# PATTGEN DV document
## Goals
* **DV**
diff --git a/hw/ip/pinmux/README.md b/hw/ip/pinmux/README.md
index 5d969f0..c9c74d6 100644
--- a/hw/ip/pinmux/README.md
+++ b/hw/ip/pinmux/README.md
@@ -1,6 +1,4 @@
----
-title: "Pinmux Technical Specification"
----
+# Pinmux Technical Specification
# Overview
diff --git a/hw/ip/pinmux/doc/checklist.md b/hw/ip/pinmux/doc/checklist.md
index 464658f..c49a72c 100644
--- a/hw/ip/pinmux/doc/checklist.md
+++ b/hw/ip/pinmux/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "Pinmux Checklist"
----
+# Pinmux Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [Pinmux peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/pinmux/doc/dv/README.md b/hw/ip/pinmux/doc/dv/README.md
index a69d1b2..09eb8a6 100644
--- a/hw/ip/pinmux/doc/dv/README.md
+++ b/hw/ip/pinmux/doc/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "PINMUX DV document"
----
+# PINMUX DV document
## Goals
* **DV**:
diff --git a/hw/ip/prim/README.md b/hw/ip/prim/README.md
index aad1c9d..789f8c8 100644
--- a/hw/ip/prim/README.md
+++ b/hw/ip/prim/README.md
@@ -1,6 +1,4 @@
----
-title: "lowRISC Hardware Primitives"
----
+# lowRISC Hardware Primitives
## Concepts
diff --git a/hw/ip/prim/doc/prim_clock_gp_mux2.md b/hw/ip/prim/doc/prim_clock_gp_mux2.md
index a3e75c8..460d8b8 100644
--- a/hw/ip/prim/doc/prim_clock_gp_mux2.md
+++ b/hw/ip/prim/doc/prim_clock_gp_mux2.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: Two input clock Mux with glitch protection"
----
+# Primitive Component: Two input clock Mux with glitch protection
# Overview
`prim_clock_gp_mux2` is a two input clock mux that protects a glitch. When a current clock source is switched to the next clock source where two clocks are totally unrelated, a glitch can be generated as follows.
diff --git a/hw/ip/prim/doc/prim_flash.md b/hw/ip/prim/doc/prim_flash.md
index ecf0901..a187d9d 100644
--- a/hw/ip/prim/doc/prim_flash.md
+++ b/hw/ip/prim/doc/prim_flash.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: Flash Wrapper"
----
+# Primitive Component: Flash Wrapper
# Overview
`prim_flash` is a wrapper interface for technology specific flash modules.
diff --git a/hw/ip/prim/doc/prim_keccak.md b/hw/ip/prim/doc/prim_keccak.md
index 0a63c71..122489e 100644
--- a/hw/ip/prim/doc/prim_keccak.md
+++ b/hw/ip/prim/doc/prim_keccak.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: Keccak permutation"
----
+# Primitive Component: Keccak permutation
# Overview
diff --git a/hw/ip/prim/doc/prim_lfsr.md b/hw/ip/prim/doc/prim_lfsr.md
index a9c3af9..a9a0178 100644
--- a/hw/ip/prim/doc/prim_lfsr.md
+++ b/hw/ip/prim/doc/prim_lfsr.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: LFSR"
----
+# Primitive Component: LFSR
# Overview
diff --git a/hw/ip/prim/doc/prim_packer.md b/hw/ip/prim/doc/prim_packer.md
index c5fdf19..f870315 100644
--- a/hw/ip/prim/doc/prim_packer.md
+++ b/hw/ip/prim/doc/prim_packer.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: Packer"
----
+# Primitive Component: Packer
# Overview
diff --git a/hw/ip/prim/doc/prim_packer_fifo.md b/hw/ip/prim/doc/prim_packer_fifo.md
index f3ad487..b79f565 100644
--- a/hw/ip/prim/doc/prim_packer_fifo.md
+++ b/hw/ip/prim/doc/prim_packer_fifo.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: Packer FIFO"
----
+# Primitive Component: Packer FIFO
# Overview
diff --git a/hw/ip/prim/doc/prim_present.md b/hw/ip/prim/doc/prim_present.md
index 858b71e..b1b2452 100644
--- a/hw/ip/prim/doc/prim_present.md
+++ b/hw/ip/prim/doc/prim_present.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: PRESENT Scrambler"
----
+# Primitive Component: PRESENT Scrambler
# Overview
diff --git a/hw/ip/prim/doc/prim_prince.md b/hw/ip/prim/doc/prim_prince.md
index e33d150..5c56bd0 100644
--- a/hw/ip/prim/doc/prim_prince.md
+++ b/hw/ip/prim/doc/prim_prince.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: PRINCE Scrambler"
----
+# Primitive Component: PRINCE Scrambler
# Overview
@@ -120,5 +118,3 @@
The reduced 32bit variant mentioned above and all reduced round variants are non-standard and must only be used for scrambling purposes, since they **are not secure**.
The 32bit variant leverages the same crypto primitives and key derivation functions as the 64bit variant, with the difference that the multiplication matrix is only comprised of the first two block diagonal submatrices (^M0 and ^M1 in the paper), and the shiftrows operation does not operate on nibbles but pairs of 2 bits instead.
-
-
diff --git a/hw/ip/prim/doc/prim_ram_1p_scr.md b/hw/ip/prim/doc/prim_ram_1p_scr.md
index 5c55be1..ffdaebc 100644
--- a/hw/ip/prim/doc/prim_ram_1p_scr.md
+++ b/hw/ip/prim/doc/prim_ram_1p_scr.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: SRAM Scrambler"
----
+# Primitive Component: SRAM Scrambler
# Overview
diff --git a/hw/ip/prim/doc/prim_xoshiro256pp.md b/hw/ip/prim/doc/prim_xoshiro256pp.md
index 8e62303..2d76852 100644
--- a/hw/ip/prim/doc/prim_xoshiro256pp.md
+++ b/hw/ip/prim/doc/prim_xoshiro256pp.md
@@ -1,6 +1,4 @@
----
-title: "Primitive Component: XoShiRo256++"
----
+# Primitive Component: XoShiRo256++
# Overviewtitle
diff --git a/hw/ip/pwm/README.md b/hw/ip/pwm/README.md
index 473b5d6..8cd40fe 100644
--- a/hw/ip/pwm/README.md
+++ b/hw/ip/pwm/README.md
@@ -1,6 +1,4 @@
----
-title: "PWM HWIP Technical Specification"
----
+# PWM HWIP Technical Specification
# Overview
diff --git a/hw/ip/pwm/doc/checklist.md b/hw/ip/pwm/doc/checklist.md
index 061cbd3..30184e6 100644
--- a/hw/ip/pwm/doc/checklist.md
+++ b/hw/ip/pwm/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "PWM Checklist"
----
+# PWM Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [PWM peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/pwm/dv/README.md b/hw/ip/pwm/dv/README.md
index d41a63d..3b5c767 100644
--- a/hw/ip/pwm/dv/README.md
+++ b/hw/ip/pwm/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "PWM DV document"
----
+# PWM DV document
## Goals
* **DV**
diff --git a/hw/ip/pwrmgr/README.md b/hw/ip/pwrmgr/README.md
index 56ce791..fbb1005 100644
--- a/hw/ip/pwrmgr/README.md
+++ b/hw/ip/pwrmgr/README.md
@@ -1,6 +1,4 @@
----
-title: "Power Manager HWIP Technical Specification"
----
+# Power Manager HWIP Technical Specification
# Overview
diff --git a/hw/ip/pwrmgr/doc/checklist.md b/hw/ip/pwrmgr/doc/checklist.md
index 373e4f8..d62e270 100644
--- a/hw/ip/pwrmgr/doc/checklist.md
+++ b/hw/ip/pwrmgr/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "PWRMGR Checklist"
----
+# PWRMGR Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [PWRMGR peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/pwrmgr/dv/README.md b/hw/ip/pwrmgr/dv/README.md
index c86d2b5..31278f4 100644
--- a/hw/ip/pwrmgr/dv/README.md
+++ b/hw/ip/pwrmgr/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "PWRMGR DV document"
----
+# PWRMGR DV document
## Goals
* **DV**
diff --git a/hw/ip/rom_ctrl/README.md b/hw/ip/rom_ctrl/README.md
index 1230ef8..ed25ac2 100644
--- a/hw/ip/rom_ctrl/README.md
+++ b/hw/ip/rom_ctrl/README.md
@@ -1,6 +1,4 @@
----
-title: ROM Controller Technical Specification
----
+# ROM Controller Technical Specification
# Overview
diff --git a/hw/ip/rom_ctrl/doc/checklist.md b/hw/ip/rom_ctrl/doc/checklist.md
index a6a4735..b53a1b1 100644
--- a/hw/ip/rom_ctrl/doc/checklist.md
+++ b/hw/ip/rom_ctrl/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "Rom Controller Checklist"
----
+# Rom Controller Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [ROM Controller peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/rom_ctrl/dv/README.md b/hw/ip/rom_ctrl/dv/README.md
index 4a83d9c..8b8f77b 100644
--- a/hw/ip/rom_ctrl/dv/README.md
+++ b/hw/ip/rom_ctrl/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "ROM Controller DV document"
----
+# ROM Controller DV document
## Goals
* **DV**
diff --git a/hw/ip/rstmgr/README.md b/hw/ip/rstmgr/README.md
index f04cf39..095d740 100644
--- a/hw/ip/rstmgr/README.md
+++ b/hw/ip/rstmgr/README.md
@@ -1,6 +1,4 @@
----
-title: "Reset Manager HWIP Technical Specification"
----
+# Reset Manager HWIP Technical Specification
# Overview
diff --git a/hw/ip/rstmgr/doc/checklist.md b/hw/ip/rstmgr/doc/checklist.md
index df61a66..d5cd380 100644
--- a/hw/ip/rstmgr/doc/checklist.md
+++ b/hw/ip/rstmgr/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "RSTMGR Checklist"
----
+# RSTMGR Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [RSTMGR peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/rstmgr/dv/README.md b/hw/ip/rstmgr/dv/README.md
index 6a3af54..6f50373 100644
--- a/hw/ip/rstmgr/dv/README.md
+++ b/hw/ip/rstmgr/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "RSTMGR DV document"
----
+# RSTMGR DV document
## Goals
* **DV**
diff --git a/hw/ip/rv_core_ibex/README.md b/hw/ip/rv_core_ibex/README.md
index f7f49a6..ae07b34 100644
--- a/hw/ip/rv_core_ibex/README.md
+++ b/hw/ip/rv_core_ibex/README.md
@@ -1,6 +1,4 @@
----
-title: "Ibex RISC-V Core Wrapper Technical Specification"
----
+# Ibex RISC-V Core Wrapper Technical Specification
# Overview
diff --git a/hw/ip/rv_core_ibex/doc/checklist.md b/hw/ip/rv_core_ibex/doc/checklist.md
index 4790acb..5637b93 100644
--- a/hw/ip/rv_core_ibex/doc/checklist.md
+++ b/hw/ip/rv_core_ibex/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "Ibex Processor Core Checklist"
----
+# Ibex Processor Core Checklist
This checklist is for [Hardware Stage][] transitions for the [Ibex Processor Core.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/rv_core_ibex/dv/README.md b/hw/ip/rv_core_ibex/dv/README.md
index 5c92ff8..8dd7f43 100644
--- a/hw/ip/rv_core_ibex/dv/README.md
+++ b/hw/ip/rv_core_ibex/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "Ibex RISC-V Core Wrapper DV document"
----
+# Ibex RISC-V Core Wrapper DV document
## Goals
* Verify compliance with the RISC-V specifications used by OpenTitan.
diff --git a/hw/ip/rv_dm/README.md b/hw/ip/rv_dm/README.md
index 0666edb..609052b 100644
--- a/hw/ip/rv_dm/README.md
+++ b/hw/ip/rv_dm/README.md
@@ -1,6 +1,4 @@
----
-title: "RISC-V Debug System Wrapper Technical Specification"
----
+# RISC-V Debug System Wrapper Technical Specification
# Overview
This document specifies the RISC-V Debug System wrapper functionality.
diff --git a/hw/ip/rv_dm/doc/checklist.md b/hw/ip/rv_dm/doc/checklist.md
index 50be755..a385473 100644
--- a/hw/ip/rv_dm/doc/checklist.md
+++ b/hw/ip/rv_dm/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "RV_DM Checklist"
----
+# RV_DM Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [RV_DM peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/rv_dm/dv/README.md b/hw/ip/rv_dm/dv/README.md
index 36f0ab1..da3d665 100644
--- a/hw/ip/rv_dm/dv/README.md
+++ b/hw/ip/rv_dm/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "RV_DM DV document"
----
+# RV_DM DV document
## Goals
* **DV**
diff --git a/hw/ip/rv_timer/README.md b/hw/ip/rv_timer/README.md
index e9231df..e4d356e 100644
--- a/hw/ip/rv_timer/README.md
+++ b/hw/ip/rv_timer/README.md
@@ -1,6 +1,4 @@
----
-title: "Timer HWIP Technical Specification"
----
+# Timer HWIP Technical Specification
# Overview
diff --git a/hw/ip/rv_timer/doc/checklist.md b/hw/ip/rv_timer/doc/checklist.md
index 0888539..994541a 100644
--- a/hw/ip/rv_timer/doc/checklist.md
+++ b/hw/ip/rv_timer/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "RV_TIMER Checklist"
----
+# RV_TIMER Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md)
transitions for the [rv_timer peripheral.](../README.md) All checklist
diff --git a/hw/ip/rv_timer/dv/README.md b/hw/ip/rv_timer/dv/README.md
index 97cd3aa..df37448 100644
--- a/hw/ip/rv_timer/dv/README.md
+++ b/hw/ip/rv_timer/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "RV_TIMER DV document"
----
+# RV_TIMER DV document
## Goals
* **DV**
diff --git a/hw/ip/spi_device/README.md b/hw/ip/spi_device/README.md
index 08fd212..2aad706 100644
--- a/hw/ip/spi_device/README.md
+++ b/hw/ip/spi_device/README.md
@@ -1,6 +1,4 @@
----
-title: "SPI Device HWIP Technical Specification"
----
+# SPI Device HWIP Technical Specification
# Overview
diff --git a/hw/ip/spi_device/doc/checklist.md b/hw/ip/spi_device/doc/checklist.md
index 0106e94..4a10ca3 100644
--- a/hw/ip/spi_device/doc/checklist.md
+++ b/hw/ip/spi_device/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "SPI_DEVICE Checklist"
----
+# SPI_DEVICE Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [spi_device peripheral](../README.md).
All checklist items refer to the content in the [Checklist](../../../../doc/project_governance/checklist/README.md).
diff --git a/hw/ip/spi_device/dv/README.md b/hw/ip/spi_device/dv/README.md
index facf32f..34c0ffc 100644
--- a/hw/ip/spi_device/dv/README.md
+++ b/hw/ip/spi_device/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "SPI Device DV document"
----
+# SPI Device DV document
## Goals
diff --git a/hw/ip/spi_host/README.md b/hw/ip/spi_host/README.md
index 1ecd193..1400346 100644
--- a/hw/ip/spi_host/README.md
+++ b/hw/ip/spi_host/README.md
@@ -1,6 +1,4 @@
----
-title: "SPI_HOST HWIP Technical Specification"
----
+# SPI_HOST HWIP Technical Specification
# Overview
diff --git a/hw/ip/spi_host/doc/checklist.md b/hw/ip/spi_host/doc/checklist.md
index c23bd66..27cf812 100644
--- a/hw/ip/spi_host/doc/checklist.md
+++ b/hw/ip/spi_host/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "SPI_HOST Checklist"
----
+# SPI_HOST Checklist
<!--
NOTE: This is a template checklist document that is required to be copied over to the 'doc'
diff --git a/hw/ip/spi_host/dv/README.md b/hw/ip/spi_host/dv/README.md
index 426dc51..ef36f08 100644
--- a/hw/ip/spi_host/dv/README.md
+++ b/hw/ip/spi_host/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "SPI_HOST DV Document"
----
+# SPI_HOST DV Document
## Goals
* **DV**
diff --git a/hw/ip/sram_ctrl/README.md b/hw/ip/sram_ctrl/README.md
index 5e51820..f7fe727 100644
--- a/hw/ip/sram_ctrl/README.md
+++ b/hw/ip/sram_ctrl/README.md
@@ -1,6 +1,4 @@
----
-title: "SRAM Controller Technical Specification"
----
+# SRAM Controller Technical Specification
# Overview
diff --git a/hw/ip/sram_ctrl/doc/checklist.md b/hw/ip/sram_ctrl/doc/checklist.md
index c6880cb..d6709d5 100644
--- a/hw/ip/sram_ctrl/doc/checklist.md
+++ b/hw/ip/sram_ctrl/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "SRAM_CTRL Checklist"
----
+# SRAM_CTRL Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [SRAM_CTRL peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/sram_ctrl/dv/README.md b/hw/ip/sram_ctrl/dv/README.md
index 97f2e3d..e10741f 100644
--- a/hw/ip/sram_ctrl/dv/README.md
+++ b/hw/ip/sram_ctrl/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "SRAM_CTRL DV document"
----
+# SRAM_CTRL DV document
## Goals
* **DV**
diff --git a/hw/ip/sysrst_ctrl/README.md b/hw/ip/sysrst_ctrl/README.md
index 9e8253f..03914bb 100644
--- a/hw/ip/sysrst_ctrl/README.md
+++ b/hw/ip/sysrst_ctrl/README.md
@@ -1,6 +1,4 @@
----
-title: "System Reset Control Technical Specification"
----
+# System Reset Control Technical Specification
# Overview
diff --git a/hw/ip/sysrst_ctrl/doc/checklist.md b/hw/ip/sysrst_ctrl/doc/checklist.md
index 37d05ea..1f3cfd6 100644
--- a/hw/ip/sysrst_ctrl/doc/checklist.md
+++ b/hw/ip/sysrst_ctrl/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "SYSRST_CTRL Checklist"
----
+# SYSRST_CTRL Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [SYSRST_CTRL peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/sysrst_ctrl/dv/README.md b/hw/ip/sysrst_ctrl/dv/README.md
index 2e5a632..8a43435 100644
--- a/hw/ip/sysrst_ctrl/dv/README.md
+++ b/hw/ip/sysrst_ctrl/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "SYSRST_CTRL DV document"
----
+# SYSRST_CTRL DV document
<!-- Copy this file to hw/ip/sysrst_ctrl/doc/dv/index.md and make changes as needed.
For convenience 'sysrst_ctrl' in the document can be searched and replaced easily with the
diff --git a/hw/ip/tlul/README.md b/hw/ip/tlul/README.md
index 3eb750d..3883359 100644
--- a/hw/ip/tlul/README.md
+++ b/hw/ip/tlul/README.md
@@ -1,6 +1,4 @@
----
-title: "Bus Specification"
----
+# Bus Specification
# Overview
diff --git a/hw/ip/tlul/doc/TlulProtocolChecker.md b/hw/ip/tlul/doc/TlulProtocolChecker.md
index 8c4cf25..684d110 100644
--- a/hw/ip/tlul/doc/TlulProtocolChecker.md
+++ b/hw/ip/tlul/doc/TlulProtocolChecker.md
@@ -1,6 +1,4 @@
----
-title: "TL-UL Protocol Checker"
----
+# TL-UL Protocol Checker
# TileLink-UL Protocol Checker
diff --git a/hw/ip/tlul/doc/dv/README.md b/hw/ip/tlul/doc/dv/README.md
index 03141ab..dcf04d9 100644
--- a/hw/ip/tlul/doc/dv/README.md
+++ b/hw/ip/tlul/doc/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "TLUL XBAR DV document"
----
+# TLUL XBAR DV document
## Goals
diff --git a/hw/ip/uart/README.md b/hw/ip/uart/README.md
index 44728f4..b3c19bc 100644
--- a/hw/ip/uart/README.md
+++ b/hw/ip/uart/README.md
@@ -1,6 +1,4 @@
----
-title: "UART HWIP Technical Specification"
----
+# UART HWIP Technical Specification
# Overview
diff --git a/hw/ip/uart/doc/checklist.md b/hw/ip/uart/doc/checklist.md
index 2451235..0b8d0e1 100644
--- a/hw/ip/uart/doc/checklist.md
+++ b/hw/ip/uart/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "UART Checklist"
----
+# UART Checklist
This checklist is for [Hardware Stage][] transitions for the [UART peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/uart/dv/README.md b/hw/ip/uart/dv/README.md
index ded2d30..5e94242 100644
--- a/hw/ip/uart/dv/README.md
+++ b/hw/ip/uart/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "UART DV document"
----
+# UART DV document
## Goals
diff --git a/hw/ip/usbdev/README.md b/hw/ip/usbdev/README.md
index 97293d0..03b8f18 100644
--- a/hw/ip/usbdev/README.md
+++ b/hw/ip/usbdev/README.md
@@ -1,6 +1,4 @@
----
-title: "USB 2.0 Full-Speed Device HWIP Technical Specification"
----
+# USB 2.0 Full-Speed Device HWIP Technical Specification
# Overview
diff --git a/hw/ip/usbdev/doc/checklist.md b/hw/ip/usbdev/doc/checklist.md
index 755ffe0..3c35ae6 100644
--- a/hw/ip/usbdev/doc/checklist.md
+++ b/hw/ip/usbdev/doc/checklist.md
@@ -1,6 +1,4 @@
----
-title: "USB Device Checklist"
----
+# USB Device Checklist
This checklist is for [Hardware Stage](../../../../doc/project_governance/development_stages.md) transitions for the [USB Device peripheral.](../README.md)
All checklist items refer to the content in the [Checklist.](../../../../doc/project_governance/checklist/README.md)
diff --git a/hw/ip/usbdev/doc/wake_resume.md b/hw/ip/usbdev/doc/wake_resume.md
index ebe9722..c151b59 100644
--- a/hw/ip/usbdev/doc/wake_resume.md
+++ b/hw/ip/usbdev/doc/wake_resume.md
@@ -1,6 +1,4 @@
----
-title: "USBDEV Suspending and Resuming with Sleep / Low Power Modes"
----
+# USBDEV Suspending and Resuming with Sleep / Low Power Modes
# Overview
diff --git a/hw/ip/usbdev/dv/README.md b/hw/ip/usbdev/dv/README.md
index 61341ea..415bd72 100644
--- a/hw/ip/usbdev/dv/README.md
+++ b/hw/ip/usbdev/dv/README.md
@@ -1,6 +1,4 @@
----
-title: "USBDEV DV document"
----
+# USBDEV DV document
## Goals
* **DV**
