Reorg side nav (#3824)

* Restructure left side navigation * Fixed links to images and tocs.
pachyderm · Jun 24, 2019 · 9ed7eb5 · 9ed7eb5
1 parent 62b7357
commit 9ed7eb5
Show file tree

Hide file tree

Showing 26 changed files with 564 additions and 349 deletions.
diff --git a/doc/auth/saml.md b/doc/auth/saml.md
@@ -71,13 +71,11 @@ Note that this example assumes
 # read-modify-write conflicts between admins
 live_config_version="$(pachctl auth get-config | jq .live_config_version)"
 live_config_version="${live_config_version:-0}"
-
 # Set the Pachyderm config
 pachctl auth set-config <<EOF
 {
   # prevent read-modify-write conflicts by explicitly specifying live version
   "live_config_version": ${live_config_version},
-
   "id_providers": [
     {
       "name": "okta",
@@ -88,7 +86,6 @@ pachctl auth set-config <<EOF
       }
     }
   ],
-
   "saml_svc_options": {
     # These URLs work if using pachctl port-forward
     "acs_url": "http://localhost:30654/saml/acs",

diff --git a/doc/conf.py b/doc/conf.py
@@ -145,7 +145,7 @@
 html_theme_options = {
    'collapse_navigation': True,
    'display_version': False,
-   'navigation_depth': 1,
+   'navigation_depth': -1,
 }
 
 # Theme options are theme-specific and customize the look and feel of a theme

diff --git a/doc/contributing/docs-style-guide.md b/doc/contributing/docs-style-guide.md
@@ -0,0 +1,3 @@
+# Documentation Style Guide
+
+This document provides
diff --git a/doc/cookbook/index.rst b/doc/cookbook/index.rst
@@ -0,0 +1,21 @@
+.. cookbook::
+
+Cookbook
+=======
+
+Pachyderm cookbook includes scenarios and use cases that you
+would typically execute while processing your data in Pachyderm.
+
+.. toctree::
+   :maxdepth: 1
+
+   splitting.md
+   combining.md
+   example_developer_workflow.md
+   cron.md
+   ml.md
+   time_windows.md
+   ingressing_from_diff_cloud.md
+   gpus.md
+   deferred_processing.md
+   vault.md
diff --git a/doc/deployment/index.rst b/doc/deployment/index.rst
@@ -0,0 +1,22 @@
+.. _deployment:
+
+Deploy Pachyderm
+================
+
+This section descirbes how to deploy Pachyderm on premises or
+on a supported cloud platform of your choice.
+
+.. toctree::
+   :maxdepth: 2
+
+   deploy_intro.md
+   google_cloud_platform.md
+   amazon_web_services.md
+   azure.md
+   openshift.md
+   on_premises.md
+   custom_object_stores.md
+   aws_cloudfront.md
+   namespaces.md
+   rbac.md
+   deploy_troubleshooting.md
diff --git a/doc/enterprise/auth.md b/doc/enterprise/auth.md