fix some warnings, perform updates on the documentation

Signed-off-by: Riccardo Iaconelli <riccardo@teamdigitale.governo.it>
docs-theme-org · Oct 6, 2017 · a8068d7 · a8068d7
1 parent d032886
commit a8068d7
Show file tree

Hide file tree

Showing 5 changed files with 36 additions and 265 deletions.
diff --git a/architecture/componentView/index.rst b/architecture/componentView/index.rst
diff --git a/architecture/index.rst b/architecture/index.rst
diff --git a/dataportal/dataportal-private.rst b/dataportal/dataportal-private.rst
@@ -1,6 +1,6 @@
-*****************
+******************
 Dataportal-private
-*****************
+******************
 
 ===========
 What it is?

diff --git a/index.rst b/index.rst
@@ -8,18 +8,47 @@ Data & Analytics Framework (DAF) - Developer Documentation
 
 .. NOTE::
 
-  This documentation refers to the Alpha version of the DAF
-  (released in October 2017) and it is daily updated and improved.
-  For comments and enhancement requests about the documentation please open
-  an issue on `Github <https://github.com/italia/daf-docs>`_.
+  This documentation refers to the Alpha version of the DAF (released in October 2017) and it is daily updated and improved.
+  For comments and enhancement requests about the documentation please open an issue on `Github <https://github.com/italia/daf-docs>`_.
 
+The `Data & Analytics Framework <https://pianotriennale-ict.readthedocs.io/en/latest/doc/09_data-analytics-framework.html>`_ (DAF, in short) is an open source project
+developed in the context of the activities planned by the
+Italian `Three-Year Plan for ICT in Public Administration 2017 - 2019 <https://pianotriennale-ict.readthedocs.io/en/latest/>`_,
+approved by the Italian Government in the 2017.
+
+In this scenario, the main goal of the DAF is to promote the exchange of
+public data between Italian PAs, to support the diffusion of open data,
+and to enable data-driven policies.
+The Italian instance of the DAF is developed and maintanied by a **Data Team** composed by data scientists and data engineers,
+which uses and evolves the framework to analyze data, create machine learning models and build data applications and data visualization products.
+
+Anyway, the DAF is a generic enough tool to be re-used in other countries
+and other application domains. In fact, the DAF is composed by:
+
+- a **Dataportal**, a Web user interface providing:
+
+   - a catalog of open-data datasets based on `CKAN <https://ckan.org>`_;
+   - a set of tools for data analysis and visualization;
+   - a tool to handle data ingestion, data and metadata management processes;
+   - a tool for publishing and sharing data stories.
+
+- a **Big Data platform** to centralize and store, manipulate and standardize and re-distribute data and insights.
+
+The DAF is under development. This is a snapshot of the roadmap:
+
+- By October 2017: Alpha release.
+- By November 2017: Beta release.
+- By December 2017: 1.0 release.
+
+Both the Alpha and Beta releases will be tested by selected communities and Italian PAs.
+
+All contributions are welcome!
 
 Contents:
 
 .. toctree::
    :maxdepth: 2
 
-    Introduction <introduction/index>
     Overview <overview/index>
     Concepts <concepts/index>
     Data Portal <dataportal/index>

diff --git a/microservices/example-microservice.rst b/microservices/example-microservice.rst