diff --git a/docs/README.md b/docs/README.md
index 3df0badcbca381d9d8a4359193898fd1fffbb0c7..841f060bce8e461cca06ab546512d7f9fe3877e9 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -12,27 +12,27 @@ to use *nshmp-haz* as well as underlying model implementation details.
 
 ## Table of Contents
 
-* [About the NSHMP](about-the-nshmp)
-* [Building & Running](building-&-running)
-  * [Developer Basics](developer-basics)
-  * [Calculation Configuration](calculation-configuration)
-  * [Site Specification](site-specification)
+* [About the NSHMP](pages/about-the-nshmp)
+* [Building & Running](pages/building-&-running)
+  * [Developer Basics](pages/developer-basics)
+  * [Calculation Configuration](pages/calculation-configuration)
+  * [Site Specification](pages/site-specification)
   * [Examples](/ghsc/nshmp/nshmp-haz/-/tree/master/etc/examples)
-* [Hazard Model](hazard-model)
-  * [Model Structure](model-structure)
-  * [Model Files](model-files)
-  * [Source Types](source-types)
-  * [Magnitude Frequency Distributions (MFDs)](magnitude-frequency-distributions-mfds)
-  * [Rupture Scaling Relations](rupture-scaling-relations)
-  * [Ground Motion Models (GMMs)](ground-motion-models-gmms)
-* [USGS Models](usgs-models)
-  * [Model Editions](model-editions)
-  * [Logic Trees & Uncertainty](logic-trees-&-uncertainty)
+* [Hazard Model](pages/hazard-model)
+  * [Model Structure](pages/model-structure)
+  * [Model Files](pages/model-files)
+  * [Source Types](pages/source-types)
+  * [Magnitude Frequency Distributions (MFDs)](pages/magnitude-frequency-distributions)
+  * [Rupture Scaling Relations](pages/rupture-scaling-relations)
+  * [Ground Motion Models (GMMs)](pages/ground-motion-models)
+* [USGS Models](pages/usgs-models)
+  * [Model Editions](pages/model-editions)
+  * [Logic Trees & Uncertainty](pages/logic-trees-&-uncertainty)
 
 ## Other Pages & References
 
 * [nshmp-lib](/ghsc/nshmp/nshmp-lib): USGS hazard modeling library
-* [Functional PSHA](functional-psha)
+* [Functional PSHA](pages/functional-psha)
 * [Probabilistic Seismic Hazard Analysis, a Primer
   [PDF]](http://www.opensha.org/sites/opensha.org/files/PSHA_Primer_v2_0.pdf)
   by Edward Field  
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