Merge branch 'doc-aggregation'

bird-house · Aug 28, 2019 · 3b58962 · 3b58962
2 parents afa014f + e98609d
commit 3b58962
Show file tree

Hide file tree

Showing 6 changed files with 19 additions and 9 deletions.
diff --git a/docs/source/_images/Documentation_aggrgation.pdf b/docs/source/_images/Documentation_aggrgation.pdf
diff --git a/docs/source/_images/Documentation_aggrgation.png b/docs/source/_images/Documentation_aggrgation.png
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -33,6 +33,7 @@
     'sphinx.ext.todo',
     'sphinx.ext.viewcode',
     'sphinxcontrib.bibtex',
+    'sphinx.ext.graphviz',
 ]
 
 # autoapi_type = 'python'

diff --git a/docs/source/overview.rst b/docs/source/overview.rst
@@ -11,18 +11,19 @@ Overview
 
 .. _introduction:
 
+
 Introduction
 ------------
 
-Birdhouse is a collaborative project open for the community to participate. It is a software framework containing a collection of
-`Web Processing Service`_ (WPS). The deployed algorithms are focusing on Earth Systems and environmental data processing with the
-philosophy of streamlining the software development and deployment. By supporting climate, earth observation and biodiversity data
-and processes, Birdhouse can be used in a wide array of Earth sciences projects and workflows. The core benefit of this project is to
-allow the seamless use of climate services developed by a diverse network of national meteorological offices, regional climate service
-providers, academics, not-for-profit research centers and private industry. As governments move toward open-data policies, there will
-be a need for analytical services that extract value out of the deluge of information. Using an interoperable software architecture,
-institutions can provide both data and services allowing users to process the data remotely from a laptop, instead of having to acquire
-and maintain large storage infrastructures.
+Birdhouse is a collaborative project open for the community to participate. It is a software framework containing a collection of `Web Processing Service`_ (WPS). The deployed algorithms are focusing on Earth Systems and environmental data processing with the
+philosophy of streamlining the software development and deployment. By supporting climate, earth observation and biodiversity data and processes, Birdhouse can be used in a wide array of Earth sciences projects and workflows. The core benefit of this project is to
+allow the seamless use of climate services developed by a diverse network of national meteorological offices, regional climate service providers, academics, not-for-profit research centers and private industry. As governments move toward open-data policies, there will be a need for analytical services that extract value out of the deluge of information. Using an interoperable software architecture, institutions can provide both data and services allowing users to process the data remotely from a laptop, instead of having to acquire and maintain large storage infrastructures.
+
+The documentation of birdhouse is representing its nature of separate software components and therefor organized in separate documentations. Birdhouse is being used by international working groups pitching up projects with individual focus on the projects objectives. The following graph shows an overview of the documentations organization and how they are aggregated to each other for a better understanding of where to find which information:
+
+
+.. image:: _images/Documentation_aggrgation.png
+
 
 .. _what_is_wps:
 

diff --git a/docs/source/projects.rst b/docs/source/projects.rst
@@ -32,6 +32,10 @@ PAVICS
 * PAVICS_: Platform for climate analysis and visualization by Ouranos_ and CRIM_, Canada.
 * PAVICS-Hydro_ : Additional services for PAVICS_ allowing users to perform hydrological modeling and analysis.
 
+.. literalinclude :: https://raw.githubusercontent.com/Ouranosinc/pavics-sdi/master/docs/source/index.rst
+   :language: rst
+
+
 A2C2
 ----
 

diff --git a/docs/source/publications.rst b/docs/source/publications.rst
@@ -14,6 +14,10 @@ Talks and articles
 
 Articles, book sections and conference proceedings and presentations related to the birdhouse projects:
 
+2019:
+
+* `UN GIS Initiative Workshop at FOSS4G Bucharest <https://github.com/nilshempelmann/presentations/raw/master/birdhouse-foss4g-2019/Hempelmann_foss4g2019.pdf>`_
+
 
 2018: