Minor adjustments

genieacs · Jun 24, 2019 · 1ef6b5a · 1ef6b5a
1 parent 16dce4f
commit 1ef6b5a
Show file tree

Hide file tree

Showing 6 changed files with 27 additions and 22 deletions.
diff --git a/docs/configuration.rst b/docs/configuration.rst
diff --git a/docs/environment-variables.rst b/docs/environment-variables.rst
@@ -0,0 +1,6 @@
+.. _environment-variables:
+
+Environment Variables
+=====================
+
+TODO
diff --git a/docs/https.rst b/docs/https.rst
@@ -0,0 +1,6 @@
+.. _https:
+
+HTTPS
+=====
+
+TODO
diff --git a/docs/index.rst b/docs/index.rst
@@ -6,6 +6,9 @@
 Welcome to GenieACS's documentation!
 ====================================
 
+.. toctree::
+  :caption: Table of Contents
+
 .. raw:: latex
 
    \part{Installation}
@@ -14,8 +17,8 @@ Welcome to GenieACS's documentation!
   :maxdepth: 1
   :caption: Installation
 
-  installation
-  configuration
+  installation-guide
+  environment-variables
 
 .. raw:: latex
 
@@ -47,4 +50,6 @@ Welcome to GenieACS's documentation!
   :maxdepth: 1
   :caption: Security
 
-  security
+  https
+  cpe-authentication
+  roles-and-permissions
diff --git a/docs/installation.rst → docs/installation-guide.rst b/docs/installation.rst → docs/installation-guide.rst
@@ -1,5 +1,5 @@
-Installation
-=============
+Installation Guide
+==================
 
 This guide is for installing GenieACS on a single server on any Linux distro
 that uses *systemd* as its init system.
@@ -10,9 +10,9 @@ a load-balancing/failover setup.
 
 .. attention::
 
-  For production deployments make sure to configure SSL and change
-  ``UI_JWT_SECRET`` to a unique and secure string. Refer to :ref:`security`
-  section for details.
+  For production deployments make sure to configure TLS and change
+  ``UI_JWT_SECRET`` to a unique and secure string. Refer to :ref:`https`
+  section for how to enable TLS to encrypt traffic.
 
 Prerequisites
 -------------
@@ -63,8 +63,8 @@ Configure systemd
 
   Create the file :file:`/opt/genieacs/genieacs.env` to hold our configuration
   options which we pass to GenieACS as environment variables. See
-  :ref:`configuration` section for a list of all available configuration
-  options.
+  :ref:`environment-variables` section for a list of all available
+  configuration options.
 
   .. code:: bash
 

diff --git a/docs/security.rst b/docs/security.rst