Add commons documentation

source/conf.py

@@ -7,7 +7,6 @@
 from recommonmark.parser import CommonMarkParser
 from recommonmark.transform import AutoStructify
 import guzzle_sphinx_theme
-import recommonmark
 
 # -- Project information -----------------------------------------------------
 
@@ -25,6 +24,7 @@
     'sphinx.ext.ifconfig',
     'sphinx.ext.imgmath',
     'sphinx.ext.intersphinx',
+    'sphinx.ext.napoleon',
     'sphinx.ext.todo',
     'sphinx.ext.viewcode',
     'sphinx_markdown_tables',
@@ -64,6 +64,12 @@
 
 suppress_warnings = ['image.nonlocal_uri']
 
+
+def missing_reference(app, env, node, contnode):
+    if node["reftype"] == "class" and node["reftarget"] == "NDArray":
+        return contnode
+
+
 def setup(app):
     app.add_config_value('recommonmark_config', {
         'url_resolver': lambda url: url.replace('.md', '.html'),
@@ -72,3 +78,4 @@ def setup(app):
     app.add_transform(AutoStructify)  # Manage avanced Markdown files with AutoStructify
     app.add_stylesheet('style.css')
     app.add_javascript('scripts.js')
+    app.connect("missing-reference", missing_reference)

source/openfisca-python-api/commons.rst

@@ -0,0 +1,7 @@
+=======
+Commons
+=======
+
+.. automodule:: openfisca_core.commons
+    :members:
+    :special-members: __call__

source/openfisca-python-api/index.md

@@ -7,6 +7,7 @@ Modules:
 .. toctree::
    :maxdepth: 1
 
+   commons
    tax-benefit-system
    variables
    parameters
@@ -21,6 +22,7 @@ Modules:
    simulation_generator
    periods
    errors
+   types
 ```
 
 Scripts:

source/openfisca-python-api/types.rst

@@ -0,0 +1,9 @@
+=====
+Types
+=====
+
+.. automodule:: openfisca_core.types
+    :members:
+
+.. automodule:: openfisca_core.types.data_types.arrays
+    :members: