[doc] Update Hugo's document index.
Cleanup Hugo's software documentation.
1. Add _index.md files under sw/ directory to unflatten the directory
index.
2. Update README.md files with Hugo document headers.
3. Skip README.md files that don't have documentation intended for
docs.opentitan.org.
Signed-off-by: Miguel Osorio <miguelosorio@google.com>
diff --git a/sw/otbn/code-snippets/README.md b/sw/otbn/code-snippets/README.md
index 618231a..4043a0f 100644
--- a/sw/otbn/code-snippets/README.md
+++ b/sw/otbn/code-snippets/README.md
@@ -1,16 +1,18 @@
-# OTBN code snippet collection
+---
+title: "OTBN Code Snippets"
+---
This directory contains some code snippets that give examples of how
to do various tasks in OTBN code.
- - `modexp.s`: An example of how to do modular exponentiation.
- - `pseudo-ops.s`: An example of the pseudo-operations supported by the OTBN ISA.
- - `mul256.s`: An example of a 256x256 bit multiply using the MULQACC
- instruction.
- - `mul384.s`: An example of a 384x384 bit multiply using the MULQACC
- instruction.
- - `barrett384.s`: An example of a modular multiplication kernel based on
- Barrett reduction.
+- `modexp.s`: An example of how to do modular exponentiation.
+- `pseudo-ops.s`: An example of the pseudo-operations supported by the OTBN ISA.
+- `mul256.s`: An example of a 256x256 bit multiply using the MULQACC
+ instruction.
+- `mul384.s`: An example of a 384x384 bit multiply using the MULQACC
+ instruction.
+- `barrett384.s`: An example of a modular multiplication kernel based on
+ Barrett reduction.
Also included in this directory is a Makefile fragment that can be
used to assemble and link the snippets. This can be used standalone or