diff --git a/firmware/index.md b/firmware/README.md
similarity index 100%
rename from firmware/index.md
rename to firmware/README.md
diff --git a/software/libcariboulite/index.md b/software/libcariboulite/README.md
similarity index 100%
rename from software/libcariboulite/index.md
rename to software/libcariboulite/README.md
diff --git a/software/libcariboulite/src/caribou_smi/index.md b/software/libcariboulite/src/caribou_smi/README.md
similarity index 100%
rename from software/libcariboulite/src/caribou_smi/index.md
rename to software/libcariboulite/src/caribou_smi/README.md
diff --git a/software/libcariboulite/src/cariboulite_eeprom/README.md b/software/libcariboulite/src/cariboulite_eeprom/README.md
new file mode 100644
index 0000000..e69de29
diff --git a/software/libcariboulite/src/soapy_api/README.md b/software/libcariboulite/src/soapy_api/README.md
new file mode 100644
index 0000000..e69de29