small changes package/module documentation templates

docs/generate.sh

 rm -rf docs/build docs/source/mod
-python docs/better_apidoc.py -l -e -d 2 -t docs/generation-templates -o docs/source/mod nifty4
+python docs/better_apidoc.py -l -e -d 3 -t docs/generation-templates -o docs/source/mod nifty4
 sphinx-build -b html docs/source/ docs/build/

docs/generation-templates/module.rst

@@ -18,9 +18,11 @@
 
     Summary
     -------
-    {% if doc:%}
+
+    {%- if doc:%}
+    Description:
     {{doc}}
-    {% endif %}
+    {%- endif %}
 
     {%- if exceptions %}
 

docs/generation-templates/package.rst

@@ -20,7 +20,8 @@
 
 
     {% if submodules %}
-    Submodules:
+    Submodules
+    ----------
 
     .. toctree::
         :maxdepth: 1
@@ -32,7 +33,8 @@
     {% if subpackages %}
 
 
-    Subpackages:
+    Subpackages
+    -----------
 
     .. toctree::
         :maxdepth: 1
@@ -46,9 +48,10 @@
     {% if members or doc %}
     Summary
     -------
-    {% if doc:%}
+    {%- if doc:%}
+    Description:
     {{doc}}
-    {% endif %}
+    {%- endif %}
 
     {%- if exceptions %}