new sectioning

noi-techpark · Aug 21, 2018 · e821c9a · e821c9a
1 parent ba1716f
commit e821c9a
Show file tree

Hide file tree

Showing 6 changed files with 15 additions and 8 deletions.
diff --git a/source/architecture.rst b/source/architecture.rst
@@ -1,7 +1,7 @@
 .. _architecture-odh:
 
-Architecture
-============
+|ODH| Architecture
+==================
 
 The architecture of the |odh| is depicted in :numref:`arch-odh`, which
 shows its composing elements together with its main goal: To gather

diff --git a/source/conf.py b/source/conf.py
@@ -86,7 +86,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This patterns also effect to html_static_path and html_extra_path
-exclude_patterns = ['replace.rst', 'dtp.rst', 'datasets']
+exclude_patterns = ['replace.rst', 'dtp.rst', 'datasets', 'domains.rst']
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.

diff --git a/source/corehacker.rst b/source/corehacker.rst
@@ -10,6 +10,7 @@ As a |odh| Core Hacker I can...
    guidelines/introduction
    guidelines/platform
    guidelines/database
+   architecture
    howto/development
 
 ...help shape the future of |odh|\.
@@ -31,6 +32,9 @@ tasks to be carried out:
    separate parts: :doc:`guidelines/platform` and
    :doc:`guidelines/database`.
 
+#. Understand the :doc:`architecture <architecture>` of both the |odh|
+   and |bdp|\.
+#. Learn about the :ref:`dtp-env`.
 #. Install the necessary software on your local workstation (be it a
    physical workstation, a virtual machine, or a Docker instance),
    including PostgreSQL with postgis extension, JDK, git.
@@ -43,6 +47,8 @@ tasks to be carried out:
    the required set up and configuration, along with some
    troubleshooting advice.
 
+
+
 #. Coding.
 
    That's the funniest part, enjoy!

diff --git a/source/dtp.rst b/source/dtp.rst
@@ -1,3 +1,6 @@
+
+.. _dtp-env:
+
 Development, Testing, and Production Environments
 =================================================
 

diff --git a/source/index.rst b/source/index.rst
@@ -11,16 +11,13 @@ Welcome to |odh| Documentation Repository!
    :includehidden:
    :caption: Table of Contents
 
-   intro
-   domains
+   Introduction & Project Overview <intro>
    datasets
-   architecture
    contribute
    user
    developer
    corehacker
-   glossary
-   licenses
+   appendices
 
 ..
    Indices and tables

diff --git a/source/intro.rst b/source/intro.rst
@@ -20,3 +20,4 @@ The technical stuff is composed of:
 * Links to the full API documentation.
 
 
+.. include:: /domains.rst