diff --git a/doc/.github/workflows/documentation.yaml b/.github/workflows/documentation.yaml
similarity index 100%
rename from doc/.github/workflows/documentation.yaml
rename to .github/workflows/documentation.yaml
diff --git a/README.rst b/README.rst
index 7a2b368..ce16a3c 100644
--- a/README.rst
+++ b/README.rst
@@ -50,6 +50,7 @@ build from source to install the package.
    # Install to your python environment!
    python -m pip install .
 
+.. _quickstartexample:
 
 Quickstart Example
 ==================
@@ -91,10 +92,11 @@ Quickstart Example
    * - Isometric
      - Dimetric
      - Trimetric
-   * - .. image:: _static/iso.svg
-     - .. image:: _static/dim.svg
-     - .. image:: _static/tri.svg
+   * - .. image:: doc/source/_static/iso.svg
+     - .. image:: doc/source/_static/dim.svg
+     - .. image:: doc/source/_static/tri.svg
 
+.. _usageexample:
 
 Usage Example
 =============
@@ -166,4 +168,4 @@ In addition to convenience methods, `svg3d` allows full control over the viewpor
 
 Running the code above generates the following image:
 
-.. image:: _static/cube-wireframe.svg
+.. image:: doc/source/_static/cube-wireframe.svg
diff --git a/doc/source/_static/truncated_cube.svg b/doc/source/_static/truncated_cube.svg
index b3dbd71..dd69d4e 100644
--- a/doc/source/_static/truncated_cube.svg
+++ b/doc/source/_static/truncated_cube.svg
@@ -1,2 +1,2 @@
 <?xml version="1.0" encoding="utf-8" ?>
-<svg baseProfile="full" height="512" version="1.1" viewBox="-0.5 -0.5 1.0 1.0" width="512" xmlns="http://www.w3.org/2000/svg" xmlns:ev="http://www.w3.org/2001/xml-events" xmlns:xlink="http://www.w3.org/1999/xlink"><defs><clipPath id="id1"><rect height="1.0" width="1.0" x="-0.5" y="-0.5" /></clipPath></defs><g clip-path="url(#id1)" fill="#71618D" fill-opacity="0.85" stroke="black" stroke-linejoin="round" stroke-width="0.005"><polygon fill="#00002A" fill-opacity="0.85" points="-0.0166733962,0.1364494356 -0.1779243261,0.1609386084 -0.1374328138,0.0029448762" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#584579" fill-opacity="0.85" points="0.1542523397,0.1537590943 0.27549571,0.0444841678 0.2354664853,0.2028964151" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#46316A" fill-opacity="0.85" points="-0.0167116171,-0.2785631872 0.1546062729,-0.2616082461 0.2757575456,-0.1276704746 0.27549571,0.0444841678 0.1542523397,0.1537590943 -0.0166733962,0.1364494356 -0.1374328138,0.0029448762 -0.1375631332,-0.1688550496" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#584579" fill-opacity="0.85" points="-0.0167116171,-0.2785631872 -0.1375631332,-0.1688550496 -0.1783327355,-0.2545758363" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#BAB3C8" fill-opacity="0.85" points="0.1546062729,-0.2616082461 0.2360082212,-0.2134774683 0.2757575456,-0.1276704746" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#1B0248" fill-opacity="0.85" points="-0.2767645808,0.1281367127 -0.277028835,-0.0447317208 -0.2361400444,-0.2034768065 -0.1783327355,-0.2545758363 -0.1375631332,-0.1688550496 -0.1374328138,0.0029448762 -0.1779243261,0.1609386084 -0.2355977039,0.2131061414" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#1B0248" fill-opacity="0.85" points="-0.1551708774,0.2625636097 -0.2355977039,0.2131061414 -0.1779243261,0.1609386084 -0.0166733962,0.1364494356 0.1542523397,0.1537590943 0.2354664853,0.2028964151 0.1788428618,0.2553040582 0.0168046167,0.2801133826" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#C6BFD1" fill-opacity="0.85" points="-0.1555290432,-0.1550317153 0.0168434423,-0.1378410354 0.1792555038,-0.1621427039 0.2360082212,-0.2134774683 0.1546062729,-0.2616082461 -0.0167116171,-0.2785631872 -0.1783327355,-0.2545758363 -0.2361400444,-0.2034768065" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#C6BFD1" fill-opacity="0.85" points="0.1387017047,0.1702526156 0.1788428618,0.2553040582 0.2354664853,0.2028964151 0.27549571,0.0444841678 0.2757575456,-0.1276704746 0.2360082212,-0.2134774683 0.1792555038,-0.1621427039 0.1388344428,-0.0029749099" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#270E51" fill-opacity="0.85" points="-0.1551708774,0.2625636097 -0.2767645808,0.1281367127 -0.2355977039,0.2131061414" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#897CA0" fill-opacity="0.85" points="0.0168046167,0.2801133826 0.1788428618,0.2553040582 0.1387017047,0.1702526156" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#9B90AF" fill-opacity="0.85" points="-0.1555290432,-0.1550317153 -0.277028835,-0.0447317208 -0.2767645808,0.1281367127 -0.1551708774,0.2625636097 0.0168046167,0.2801133826 0.1387017047,0.1702526156 0.1388344428,-0.0029749099 0.0168434423,-0.1378410354" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#897CA0" fill-opacity="0.85" points="-0.1555290432,-0.1550317153 -0.2361400444,-0.2034768065 -0.277028835,-0.0447317208" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#EBE9EF" fill-opacity="0.85" points="0.0168434423,-0.1378410354 0.1388344428,-0.0029749099 0.1792555038,-0.1621427039" stroke="black" stroke-linejoin="round" stroke-width="0.005" /></g></svg>
\ No newline at end of file
+<svg baseProfile="full" height="512" version="1.1" viewBox="-0.5 -0.5 1.0 1.0" width="512" xmlns="http://www.w3.org/2000/svg" xmlns:ev="http://www.w3.org/2001/xml-events" xmlns:xlink="http://www.w3.org/1999/xlink"><defs><clipPath id="id1"><rect height="1.0" width="1.0" x="-0.5" y="-0.5" /></clipPath></defs><g clip-path="url(#id1)" fill="#71618D" fill-opacity="0.85" stroke="black" stroke-linejoin="round" stroke-width="0.005"><polygon fill="#00002A" fill-opacity="0.85" points="-0.0166733962,0.1364494356 -0.1779243261,0.1609386084 -0.1374328138,0.0029448762" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#584579" fill-opacity="0.85" points="0.1542523397,0.1537590943 0.27549571,0.0444841678 0.2354664853,0.2028964151" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#46316A" fill-opacity="0.85" points="-0.0167116171,-0.2785631872 0.1546062729,-0.2616082461 0.2757575456,-0.1276704746 0.27549571,0.0444841678 0.1542523397,0.1537590943 -0.0166733962,0.1364494356 -0.1374328138,0.0029448762 -0.1375631332,-0.1688550496" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#584579" fill-opacity="0.85" points="-0.0167116171,-0.2785631872 -0.1375631332,-0.1688550496 -0.1783327355,-0.2545758363" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#BAB3C8" fill-opacity="0.85" points="0.1546062729,-0.2616082461 0.2360082212,-0.2134774683 0.2757575456,-0.1276704746" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#1B0248" fill-opacity="0.85" points="-0.2767645808,0.1281367127 -0.277028835,-0.0447317208 -0.2361400444,-0.2034768065 -0.1783327355,-0.2545758363 -0.1375631332,-0.1688550496 -0.1374328138,0.0029448762 -0.1779243261,0.1609386084 -0.2355977039,0.2131061414" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#1B0248" fill-opacity="0.85" points="-0.1551708774,0.2625636097 -0.2355977039,0.2131061414 -0.1779243261,0.1609386084 -0.0166733962,0.1364494356 0.1542523397,0.1537590943 0.2354664853,0.2028964151 0.1788428618,0.2553040582 0.0168046167,0.2801133826" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#C6BFD1" fill-opacity="0.85" points="-0.1555290432,-0.1550317153 0.0168434423,-0.1378410354 0.1792555038,-0.1621427039 0.2360082212,-0.2134774683 0.1546062729,-0.2616082461 -0.0167116171,-0.2785631872 -0.1783327355,-0.2545758363 -0.2361400444,-0.2034768065" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#C6BFD1" fill-opacity="0.85" points="0.1387017047,0.1702526156 0.1788428618,0.2553040582 0.2354664853,0.2028964151 0.27549571,0.0444841678 0.2757575456,-0.1276704746 0.2360082212,-0.2134774683 0.1792555038,-0.1621427039 0.1388344428,-0.0029749099" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#270E51" fill-opacity="0.85" points="-0.1551708774,0.2625636097 -0.2767645808,0.1281367127 -0.2355977039,0.2131061414" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#897CA0" fill-opacity="0.85" points="0.0168046167,0.2801133826 0.1788428618,0.2553040582 0.1387017047,0.1702526156" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#9B90AF" fill-opacity="0.85" points="-0.1555290432,-0.1550317153 -0.277028835,-0.0447317208 -0.2767645808,0.1281367127 -0.1551708774,0.2625636097 0.0168046167,0.2801133826 0.1387017047,0.1702526156 0.1388344428,-0.0029749099 0.0168434423,-0.1378410354" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#897CA0" fill-opacity="0.85" points="-0.1555290432,-0.1550317153 -0.2361400444,-0.2034768065 -0.277028835,-0.0447317208" stroke="black" stroke-linejoin="round" stroke-width="0.005" /><polygon fill="#EBE9EF" fill-opacity="0.85" points="0.0168434423,-0.1378410354 0.1388344428,-0.0029749099 0.1792555038,-0.1621427039" stroke="black" stroke-linejoin="round" stroke-width="0.005" /></g></svg>
diff --git a/doc/source/index.rst b/doc/source/index.rst
index a6bab5e..4ec27d3 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -23,7 +23,9 @@
 
 .. include:: ../../README.rst
     :start-after: .. _imheader:
-    :end-before: Usage Example
+    :end-before: .. _quickstartexample:
+
+.. include:: quickstart.rst
 
 .. toctree::
    :maxdepth: 2
diff --git a/doc/source/quickstart.rst b/doc/source/quickstart.rst
index af06298..338e380 100644
--- a/doc/source/quickstart.rst
+++ b/doc/source/quickstart.rst
@@ -1,6 +1,13 @@
-Quickstart Example
-==================
-
 .. include:: ../../README.rst
-    :start-after: Quickstart Example
-    :end-before: Usage Example
+    :start-after: .. _quickstartexample:
+    :end-before: .. list-table::
+
+.. list-table::
+   :header-rows: 1
+
+   * - Isometric
+     - Dimetric
+     - Trimetric
+   * - .. image:: _static/iso.svg
+     - .. image:: _static/dim.svg
+     - .. image:: _static/tri.svg
diff --git a/doc/source/usage-example.rst b/doc/source/usage-example.rst
index 288a756..734a174 100644
--- a/doc/source/usage-example.rst
+++ b/doc/source/usage-example.rst
@@ -1,5 +1,5 @@
-Usage Example
-==================
-
 .. include:: ../../README.rst
-    :start-after: Usage Example
+    :start-after: .. _usageexample:
+    :end-before: Running the code above generates the following image
+
+.. image:: _static/cube-wireframe.svg