readthedocs
diff --git a/‎docs/guides/adding-custom-css.rst renamed to ‎docs/guides/how-to/adding-custom-css.rst b/‎docs/guides/adding-custom-css.rst renamed to ‎docs/guides/how-to/adding-custom-css.rst
diff --git a/‎docs/guides/build-notifications.rst renamed to ‎docs/guides/how-to/build-notifications.rst b/‎docs/guides/build-notifications.rst renamed to ‎docs/guides/how-to/build-notifications.rst
diff --git a/‎docs/guides/build-using-too-many-resources.rst renamed to ‎docs/guides/how-to/build-using-too-many-resources.rst b/‎docs/guides/build-using-too-many-resources.rst renamed to ‎docs/guides/how-to/build-using-too-many-resources.rst
diff --git a/‎docs/guides/index.rst renamed to ‎docs/guides/how-to/index.rst
Lines changed: 2 additions & 10 deletions b/‎docs/guides/index.rst renamed to ‎docs/guides/how-to/index.rst
Lines changed: 2 additions & 10 deletions
diff --git a/‎docs/guides/manage-translations.rst renamed to ‎docs/guides/how-to/manage-translations.rst b/‎docs/guides/manage-translations.rst renamed to ‎docs/guides/how-to/manage-translations.rst
diff --git a/‎docs/guides/remove-edit-buttons.rst renamed to ‎docs/guides/how-to/remove-edit-buttons.rst b/‎docs/guides/remove-edit-buttons.rst renamed to ‎docs/guides/how-to/remove-edit-buttons.rst
diff --git a/‎docs/guides/technical-docs-seo-guide.rst renamed to ‎docs/guides/how-to/technical-docs-seo-guide.rst b/‎docs/guides/technical-docs-seo-guide.rst renamed to ‎docs/guides/how-to/technical-docs-seo-guide.rst
diff --git a/‎docs/guides/canonical.rst renamed to ‎docs/guides/troubleshooting/canonical.rst b/‎docs/guides/canonical.rst renamed to ‎docs/guides/troubleshooting/canonical.rst
diff --git a/‎docs/guides/conda.rst renamed to ‎docs/guides/troubleshooting/conda.rst b/‎docs/guides/conda.rst renamed to ‎docs/guides/troubleshooting/conda.rst
diff --git a/‎docs/guides/custom-404-page.rst renamed to ‎docs/guides/troubleshooting/custom-404-page.rst b/‎docs/guides/custom-404-page.rst renamed to ‎docs/guides/troubleshooting/custom-404-page.rst
diff --git a/‎docs/guides/environment-variables.rst renamed to ‎docs/guides/troubleshooting/environment-variables.rst b/‎docs/guides/environment-variables.rst renamed to ‎docs/guides/troubleshooting/environment-variables.rst
diff --git a/‎docs/guides/feature-flags.rst renamed to ‎docs/guides/troubleshooting/feature-flags.rst b/‎docs/guides/feature-flags.rst renamed to ‎docs/guides/troubleshooting/feature-flags.rst
diff --git a/‎docs/guides/google-analytics.rst renamed to ‎docs/guides/troubleshooting/google-analytics.rst b/‎docs/guides/google-analytics.rst renamed to ‎docs/guides/troubleshooting/google-analytics.rst
diff --git a/‎docs/guides/troubleshooting/index.rst
Lines changed: 34 additions & 0 deletions b/‎docs/guides/troubleshooting/index.rst
Lines changed: 34 additions & 0 deletions
diff --git a/‎docs/guides/mkdocs-old-versions.rst renamed to ‎docs/guides/troubleshooting/mkdocs-old-versions.rst b/‎docs/guides/mkdocs-old-versions.rst renamed to ‎docs/guides/troubleshooting/mkdocs-old-versions.rst
diff --git a/‎docs/guides/pdf-non-ascii-languages.rst renamed to ‎docs/guides/troubleshooting/pdf-non-ascii-languages.rst b/‎docs/guides/pdf-non-ascii-languages.rst renamed to ‎docs/guides/troubleshooting/pdf-non-ascii-languages.rst
diff --git a/‎docs/guides/sitemaps.rst renamed to ‎docs/guides/troubleshooting/sitemaps.rst b/‎docs/guides/sitemaps.rst renamed to ‎docs/guides/troubleshooting/sitemaps.rst
diff --git a/‎docs/guides/specifying-dependencies.rst renamed to ‎docs/guides/troubleshooting/specifying-dependencies.rst b/‎docs/guides/specifying-dependencies.rst renamed to ‎docs/guides/troubleshooting/specifying-dependencies.rst
diff --git a/‎docs/guides/vcs.rst renamed to ‎docs/guides/troubleshooting/vcs.rst b/‎docs/guides/vcs.rst renamed to ‎docs/guides/troubleshooting/vcs.rst
diff --git a/‎docs/guides/wipe-environment.rst renamed to ‎docs/guides/troubleshooting/wipe-environment.rst b/‎docs/guides/wipe-environment.rst renamed to ‎docs/guides/troubleshooting/wipe-environment.rst
@@ -18,12 +18,9 @@ whether that is Sphinx or MkDocs.
     adding-custom-css
     custom-404-page
     manage-translations
-    mkdocs-old-versions
-    pdf-non-ascii-languages
     remove-edit-buttons
     vcs
 
-
 Read the Docs how-to guides
 ---------------------------
 
@@ -33,13 +30,8 @@ These guides will help you customize or tune aspects of the Read the Docs build
     :maxdepth: 1
 
     build-notifications
-    build-using-too-many-resources
     technical-docs-seo-guide
-    canonical
-    conda
-    environment-variables
-    feature-flags
-    google-analytics
-    sitemaps
     specifying-dependencies
     wipe-environment
+    google-analytics
+    sitemaps
@@ -0,0 +1,34 @@
+Troubleshooting Guides
+======================
+
+These guides will help walk you through troubleshooting steps
+related to Read the Docs itself, documentation tools like Sphinx and MkDocs
+and how to write successful documentation.
+
+
+Sphinx & MkDocs troubleshooting guides
+--------------------------------------
+
+These are the troubleshooting guides for your documentation authoring tool
+whether that is Sphinx or MkDocs.
+
+.. toctree::
+    :maxdepth: 1
+
+    mkdocs-old-versions
+    pdf-non-ascii-languages
+    remove-edit-buttons
+
+
+Read the Docs troubleshooting guides
+-------------------------------------
+
+These troubleshooting guides are for the Read the Docs build environment.
+
+.. toctree::
+    :maxdepth: 1
+
+    canonical
+    conda
+    environment-variables
+    specifying-dependencies