diff --git a/docs/index.md b/docs/index.md
index fd1ff86..238348c 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -9,6 +9,7 @@ hidden:
 ---
 raster_index/aligning
 raster_index/combining
+raster_index/design_choices
 ```
 
 ```{toctree}
diff --git a/docs/raster_index/design_choices.md b/docs/raster_index/design_choices.md
new file mode 100644
index 0000000..8dbb63a
--- /dev/null
+++ b/docs/raster_index/design_choices.md
@@ -0,0 +1,8 @@
+```{eval-rst}
+.. currentmodule:: rasterix
+```
+
+# Design Choices
+
+In designing {py:class}`RasterIndex`, we faced a few thorny questions. Below we discuss these considerations, and the approach we've taken.
+Ultimately, there are no easy answers and tradeoffs to be made.