[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