From 859b119275dd8a63650e14129ed8129bcb9b3626 Mon Sep 17 00:00:00 2001
From: Deepak Cherian <deepak@cherian.net>
Date: Mon, 30 Jun 2025 17:42:24 -0600
Subject: [PATCH] Add  empty design choices page

---
 docs/index.md                       | 1 +
 docs/raster_index/design_choices.md | 8 ++++++++
 2 files changed, 9 insertions(+)
 create mode 100644 docs/raster_index/design_choices.md

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.