Work on docs

docs/apps/index.rst

-Apps
-====
-
-.. toctree::
-   :maxdepth: 2
-
-   scipost
-   submissions
-   journals
-   comments
-   commentaries
-   theses

docs/codebase/apps/index.rst

+Apps
+====
+
+.. toctree::
+   :maxdepth: 2
+
+   scipost
+   submissions
+   journals
+   colleges
+   commentaries
+   comments
+   common
+   conflicts
+   finances
+   forums
+   funders
+   guides
+   helpdesk
+   invitations
+   journals
+   mailing_lists
+   mails
+   metacore
+   news
+   notifications
+   ontology
+   organizations
+   preprints
+   proceedings
+   production
+   profiles
+   sponsors
+   stats
+   submissions
+   theses

docs/codebase/index.rst

+########
+Codebase
+########
+
+This section of the SciPost documentation is intended for developers.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contents:
+
+   installation/index
+   apps/index

docs/deployment/index.rst

@@ -3,8 +3,15 @@ Deployment
 ##########
 
 
+These pages describe the details of how SciPost is deployed, including:
+
+* teams (with roles and members)
+* deployment details and how-to for all applications
+
+
 .. toctree::
    :maxdepth: 2
+   :caption: Contents:
 
    team
    deployment

docs/index.rst

-##############################
-SciPost codebase documentation
-##############################
+#####################
+SciPost documentation
+#####################
 
 .. toctree::
    :maxdepth: 1
    :caption: Contents:
 
-   installation/index
+   codebase/index
    deployment/index
    maintenance/index
-   apps/index
+
+
+These pages contain all the documentation necessary to understand how
+SciPost is implemented and run.