fix(docs): add missing extension napoleon

Author: oesteban

Diff for: .circleci/config.yml

@@ -284,6 +284,9 @@ jobs:
           command: |
               apt-get update
               apt-get install -y graphviz
+      - run:
+          name: Install Requirements (may contain pinned versions)
+          command: python -m pip install -r docs/requirements.txt
       - run:
           name: Install fMRIPrep
           command: python -m pip install ".[doc]"

Diff for: .readthedocs.yml

@@ -1,7 +1,9 @@
 version: 2
 
 python:
+  version: 3.7
   install:
+    - requirements: docs/requirements.txt
     - method: pip
       path: .
       extra_requirements:

Diff for: docs/conf.py

@@ -44,6 +44,7 @@
     'sphinxarg.ext',  # argparse extension
     'nipype.sphinxext.plot_workflow',
     'nbsphinx',
+    'sphinxcontrib.napoleon',
 ]
 
 # Mock modules in autodoc:
@@ -63,6 +64,16 @@
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
+# Accept custom section names to be parsed for numpy-style docstrings
+# of parameters.
+# Requires pinning sphinxcontrib-napoleon to a specific commit while
+# https://github.com/sphinx-contrib/napoleon/pull/10 is merged.
+napoleon_use_param = False
+napoleon_custom_sections = [
+    ('Inputs', 'Parameters'),
+    ('Outputs', 'Parameters'),
+]
+
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 # source_suffix = ['.rst', '.md']

Diff for: docs/requirements.txt

@@ -0,0 +1 @@
+git+https://github.com/AleksandarPetrov/napoleon.git@0dc3f28a309ad602be5f44a9049785a1026451b3#egg=sphinxcontrib-napoleon

Diff for: setup.cfg

@@ -58,6 +58,7 @@ doc =
     sphinx >=1.5.3
     sphinx-argparse
     sphinx_rtd_theme
+    sphinxcontrib-napoleon
 docs =
     %(doc)s
 duecredit = duecredit