small changes package/module documentation templates

docs/generation-templates/module.rst

@@ -7,6 +7,11 @@
 ({{ fullname }} module)
 {% endif %}
 
+{%- if doc %}
+{{doc}}
+{%- endif %}
+
+
 .. currentmodule:: {{ fullname }}
 
 .. automodule:: {{ fullname }}
@@ -19,11 +24,6 @@
     Summary
     -------
 
-    {%- if doc:%}
-    Description:
-    {{doc}}
-    {%- endif %}
-
     {%- if exceptions %}
 
     Exceptions:

docs/generation-templates/package.rst

@@ -2,13 +2,16 @@
 {{ name }}
 {% for item in range(8 + name|length) -%}={%- endfor %}
 ({{ fullname }} package)
-
 {% else %}
 {{ fullname }}
 {% for item in range(8 + fullname|length) -%}={%- endfor %}
 ({{ fullname }} package)
 {% endif %}
 
+{%- if doc %}
+{{doc}}
+{%- endif %}
+
 .. automodule:: {{ fullname }}
     {% if members -%}
     :members: {{ members|join(", ") }}
@@ -17,8 +20,6 @@
     {%- endif %}
 
 
-
-
     {% if submodules %}
     Submodules
     ----------
@@ -45,13 +46,9 @@
 
     {%- endif %}
 
-    {% if members or doc %}
+    {% if members %}
     Summary
     -------
-    {%- if doc:%}
-    Description:
-    {{doc}}
-    {%- endif %}
 
     {%- if exceptions %}