DOC: Use the "autosummary" extension

Author: mgeier

doc/api.rst

@@ -0,0 +1,14 @@
+API Documentation
+=================
+
+.. currentmodule:: sfs
+
+.. autosummary::
+    :toctree:
+
+    array
+    tapering
+    mono
+    time
+    plot
+    util

doc/arrays.rst

@@ -32,6 +32,7 @@
 # ones.
 extensions = [
     'sphinx.ext.autodoc',
+    'sphinx.ext.autosummary',
     'sphinx.ext.mathjax',
     'sphinx.ext.viewcode',
     'sphinx.ext.napoleon',  # support for NumPy-style docstrings
@@ -49,6 +50,8 @@
 autodoc_member_order = 'bysource'
 autodoc_default_flags = ['members', 'undoc-members']
 
+autosummary_generate = ['api']
+
 napoleon_google_docstring = False
 napoleon_numpy_docstring = True
 napoleon_include_private_with_doc = False

doc/conf.py

@@ -6,11 +6,7 @@
 
     installation
     examples/index
-    arrays
-    frequency-domain
-    time-domain
-    plotting
-    utilities
+    api
     references
     contributing
     version-history

doc/frequency-domain.rst

@@ -1 +1,3 @@
+.. default-role:: py:obj
+
 .. include:: ../NEWS.rst

doc/index.rst

@@ -8,9 +8,6 @@
     plt.rcParams['figure.figsize'] = 8, 4.5  # inch
     plt.rcParams['axes.grid'] = True
 
-.. autoclass:: ArrayData
-   :members: take
-
 """
 from collections import namedtuple
 import numpy as np