add docs requirements for readthedocs install

Author: josephmje

.readthedocs.yml

@@ -0,0 +1,6 @@
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - doc

docs/conf.py

@@ -37,7 +37,8 @@
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.viewcode",
-    "sphinx_click.ext"
+    "sphinx.ext.napoleon",
+    "sphinx_click.ext",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -132,13 +133,7 @@
 # (source start file, target name, title, author, documentclass
 # [howto, manual, or own class]).
 latex_documents = [
-    (
-        master_doc,
-        "dmriprep.tex",
-        "dmriprep Documentation",
-        author,
-        "manual",
-    )
+    (master_doc, "dmriprep.tex", "dmriprep Documentation", author, "manual")
 ]
 
 

docs/outputs.rst

@@ -1,2 +1,18 @@
-Outputs
-=======
+Outputs of dMRIPrep
+===================
+
+dMRIPrep generates:
+
+  1. **Visual QA (quality assurance) reports**
+
+  2. **Pre-processed imaging data**
+
+Visual Reports
+--------------
+
+Preprocessed data (dMRIPrep *derivatives*)
+------------------------------------------
+
+Anatomical derivatives are placed in each subject's ``anat`` subfolder:
+
+Diffusion derivatives are stored in the ``dwi`` subfolder.