Work on docs

docs/codebase/apps/index.rst

@@ -15,7 +15,7 @@ Core apps
 .. toctree::
    :maxdepth: 1
 
-   scipost
+   scipost/index
    common
 
 

docs/codebase/apps/scipost/admin.rst

+Admin
+-----
+.. automodule:: scipost.admin
+   :members:
+   :undoc-members:

docs/codebase/apps/scipost/forms.rst

+Forms
+-----
+.. automodule:: scipost.forms
+   :members:
+   :undoc-members:

docs/codebase/apps/scipost/index.rst

+scipost
+=======
+
+
+Core modules
+------------
+
+.. toctree::
+   :maxdepth: 1
+
+   urls
+   models
+   forms
+   views
+   admin
+
+
+Other modules
+-------------
+
+.. toctree::
+   :maxdepth: 1

docs/codebase/apps/scipost.rst → docs/codebase/apps/scipost/models.rst

-scipost
-=======
-
-
 Models
 ------
 .. automodule:: scipost.models
    :members:
-
-Views
------
-
-.. automodule:: scipost.views
-   :members:
+   :undoc-members:

docs/codebase/apps/scipost/urls.rst

+URLs
+----
+.. automodule:: scipost.urls
+   :members:
+   :undoc-members:
+
+   .. autodata:: urlpatterns

docs/codebase/apps/scipost/views.rst

+Views
+-----
+.. automodule:: scipost.views
+   :members:
+   :undoc-members:

docs/index.rst

@@ -4,12 +4,22 @@ SciPost
 
 Welcome to SciPost's infrastructure documentation.
 
-The SciPost project aims to transform academic publishing through the creation,
-operation and maintenance of a full-fledged, academically-owned infrastructure.
-More details about our initiative can be found
-at `scipost.org/about <https://scipost.org/about>`_.
-
-This document is meant for geeks, techies and the plain curious.
+The `SciPost <https://scipost.org>`_ project aims to transform academic publishing
+through the creation,
+operation and maintenance of a full-fledged, top-quality,
+open-sourced and academically-run infrastructure.
+
+By building the machines and leaving the keys in the hands of academia, we intend
+to provide scientists worldwide with a healthier publishing and evaluation workflow,
+free of profiteering or further non-scientific interests.
+
+To see the concrete results of our activities, start with a visit to our main site
+at `scipost.org <https://scipost.org>`_.
+Our guiding principles are listed on our `about page <https://scipost.org/about>`_.
+You should also, at least once in your life, familiarize yourself with
+our academically healthy `business model <https://scipost.org/finances/business_model/>`_.
+
+This document is meant for good-willed geeks, techies and the plain curious.
 You will find here a description of the assets and facilities we are building
 to turn our vision into reality, most importantly:
 
@@ -28,7 +38,6 @@ the :doc:`SciPost Foundation <foundation/index>`
 and :doc:`the infrastructure team <team>`.
 
 
-
 .. toctree::
    :maxdepth: 1
    :caption: Contents: