diff --git a/docs/README.md b/docs/README.md
index 3df0badcbca381d9d8a4359193898fd1fffbb0c7..55490d24ff3d9a4326280c614ce6b54c6197f4ff 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -12,7 +12,7 @@ to use *nshmp-haz* as well as underlying model implementation details.
 
 ## Table of Contents
 
-* [About the NSHMP](about-the-nshmp)
+* [About the NSHMP](pages/about-the-nshmp)
 * [Building & Running](building-&-running)
   * [Developer Basics](developer-basics)
   * [Calculation Configuration](calculation-configuration)
diff --git a/docs/_Sidebar.md b/docs/_Sidebar.md
deleted file mode 100644
index 62cef14112021542232f4fe7ff56344b7d084d4e..0000000000000000000000000000000000000000
--- a/docs/_Sidebar.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# Sidebar
-
-[Home](home)  
-[Building & Running](building-&-running)  
-   â€“ [Configuration](calculation-configuration)  
-   â€“ [Site Specification](site-specification)  
-[Source Model Files](model-files)  
-   â€“ [Source Types](source-types)  
-   â€“ [Ground Motion Models](ground-motion-models)  
-   â€“ [USGS Models](usgs-models)  
-   â€“ [Uncertainties](uncertainties-in-nshms)  
-[Examples](https://github.com/usgs/nshmp-haz/tree/master/etc/examples)  
-[Dependencies](developer-tools) and [Development](developer-basics)  
-[Functional PSHA](functional-psha)  
-[API Docs](http://usgs.github.io/nshmp-haz/javadoc)  
-[License](https://github.com/usgs/nshmp-haz/blob/master/LICENSE.md)
-
-![USGS logo](images/usgs-icon.png)  [U.S. Geological Survey](https://www.usgs.gov)
-
-National Seismic Hazard Mapping Project ([NSHMP](https://earthquake.usgs.gov/hazards/))
diff --git a/docs/About-the-NSHMP.md b/docs/pages/About-the-NSHMP.md
similarity index 100%
rename from docs/About-the-NSHMP.md
rename to docs/pages/About-the-NSHMP.md
diff --git a/docs/Building-&-Running.md b/docs/pages/Building-&-Running.md
similarity index 100%
rename from docs/Building-&-Running.md
rename to docs/pages/Building-&-Running.md
diff --git a/docs/Calculation-Configuration.md b/docs/pages/Calculation-Configuration.md
similarity index 100%
rename from docs/Calculation-Configuration.md
rename to docs/pages/Calculation-Configuration.md
diff --git a/docs/Developer-Basics.md b/docs/pages/Developer-Basics.md
similarity index 100%
rename from docs/Developer-Basics.md
rename to docs/pages/Developer-Basics.md
diff --git a/docs/Functional-PSHA.md b/docs/pages/Functional-PSHA.md
similarity index 100%
rename from docs/Functional-PSHA.md
rename to docs/pages/Functional-PSHA.md
diff --git a/docs/Ground-Motion-Models.md b/docs/pages/Ground-Motion-Models.md
similarity index 100%
rename from docs/Ground-Motion-Models.md
rename to docs/pages/Ground-Motion-Models.md
diff --git a/docs/Hazard-Model.md b/docs/pages/Hazard-Model.md
similarity index 100%
rename from docs/Hazard-Model.md
rename to docs/pages/Hazard-Model.md
diff --git a/docs/Logic-Trees-&-Uncertainty.md b/docs/pages/Logic-Trees-&-Uncertainty.md
similarity index 100%
rename from docs/Logic-Trees-&-Uncertainty.md
rename to docs/pages/Logic-Trees-&-Uncertainty.md
diff --git a/docs/Magnitude-Frequency-Distributions.md b/docs/pages/Magnitude-Frequency-Distributions.md
similarity index 100%
rename from docs/Magnitude-Frequency-Distributions.md
rename to docs/pages/Magnitude-Frequency-Distributions.md
diff --git a/docs/Model Editions.md b/docs/pages/Model Editions.md
similarity index 100%
rename from docs/Model Editions.md
rename to docs/pages/Model Editions.md
diff --git a/docs/Model-Files.md b/docs/pages/Model-Files.md
similarity index 100%
rename from docs/Model-Files.md
rename to docs/pages/Model-Files.md
diff --git a/docs/Model-Structure.md b/docs/pages/Model-Structure.md
similarity index 100%
rename from docs/Model-Structure.md
rename to docs/pages/Model-Structure.md
diff --git a/docs/Rupture-Scaling-Relations.md b/docs/pages/Rupture-Scaling-Relations.md
similarity index 100%
rename from docs/Rupture-Scaling-Relations.md
rename to docs/pages/Rupture-Scaling-Relations.md
diff --git a/docs/Site-Specification.md b/docs/pages/Site-Specification.md
similarity index 100%
rename from docs/Site-Specification.md
rename to docs/pages/Site-Specification.md
diff --git a/docs/Source-Types.md b/docs/pages/Source-Types.md
similarity index 100%
rename from docs/Source-Types.md
rename to docs/pages/Source-Types.md
diff --git a/docs/USGS-Models.md b/docs/pages/USGS-Models.md
similarity index 98%
rename from docs/USGS-Models.md
rename to docs/pages/USGS-Models.md
index 7db49c8f70b3e61646fd2a11826107c631594d05..ded6d6e1c25d05a4963a08058332d134750cf884 100644
--- a/docs/USGS-Models.md
+++ b/docs/pages/USGS-Models.md
@@ -30,7 +30,7 @@ Each model region has a dedicated repository with version tags marking different
 * [Model Editions](model-editions)
 * [Logic Trees & Uncertainty](logic-trees-&-uncertainty)
 
-[**Documentation Index**](readme)
+[**Documentation Index**](../readme)
 
 ---
 ![USGS logo](images/usgs-icon.png)  [U.S. Geological Survey](https://www.usgs.gov)
diff --git a/docs/images/psha-formula.png b/docs/pages/images/psha-formula.png
similarity index 100%
rename from docs/images/psha-formula.png
rename to docs/pages/images/psha-formula.png
diff --git a/docs/images/psha-functional.png b/docs/pages/images/psha-functional.png
similarity index 100%
rename from docs/images/psha-functional.png
rename to docs/pages/images/psha-functional.png
diff --git a/docs/images/psha-linear.png b/docs/pages/images/psha-linear.png
similarity index 100%
rename from docs/images/psha-linear.png
rename to docs/pages/images/psha-linear.png
diff --git a/docs/images/usgs-icon.png b/docs/pages/images/usgs-icon.png
similarity index 100%
rename from docs/images/usgs-icon.png
rename to docs/pages/images/usgs-icon.png