diff --git a/docs/how-to/index.md b/docs/how-to/index.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/how-to/v0/index.md b/docs/how-to/v0/index.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/how-to/v1/biomass-model-inference.md b/docs/how-to/v1/biomass-model-inference.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/how-to/v1/biomass-model-training.md b/docs/how-to/v1/biomass-model-training.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/how-to/v1/biomass-training-data.md b/docs/how-to/v1/biomass-training-data.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/how-to/v1/glas-processing.md b/docs/how-to/v1/glas-processing.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/how-to/v1/post-process-biomass-predictions.md b/docs/how-to/v1/post-process-biomass-predictions.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/how-to/viirs-fire-workflow.md b/docs/how-to/viirs-fire-workflow.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..323faf9
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,10 @@
+# carbonplan / trace
+
+This is an open source research project with the goal of tracking emissions related to biomass losses from forests.
+
+<!-- links to sub sections -->
+
+|             |               |
+| ----------- | ------------- |
+| quick-start | how-to guides |
+| references  | api           |
diff --git a/docs/quick-start.md b/docs/quick-start.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/references/forest-emissions.md b/docs/references/forest-emissions.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/references/index.md b/docs/references/index.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/references/roadmap.md b/docs/references/roadmap.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/references/v0-overview.md b/docs/references/v0-overview.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/references/v1-overview.md b/docs/references/v1-overview.md
new file mode 100644
index 0000000..e69de29