Improve docs

docs/_static/css/custom.css

@@ -1,7 +1,46 @@
-.table-wrapper {
+table.autosummary.longtable.docutils.align-default {
+  margin-left: 0 !important;
+  margin-bottom: 0 !important;
+  border-collapse: collapse;
+  width: 100%;
+}
+
+table.autosummary.longtable.docutils.align-default tbody>tr.row-odd>td {
+  white-space: normal;
+  overflow-wrap: break-word;
+}
+
+table.autosummary.longtable.docutils.align-default tbody>tr.row-even>td {
+  white-space: normal;
+  overflow-wrap: break-word;
+}
+
+.admonition {
+  font-size: 0.8rem;
+  margin-bottom: 12px !important;
+}
+
+li.toctree-l1>ul {
   margin-top: 0 !important;
+  margin-bottom: 0 !important;
 }
 
-table.autosummary.longtable.docutils.align-default {
-  margin-left: 0 !important;
+section>h2 {
+  margin-top: 1.5em !important;
+  margin-bottom: 0.5em !important;
+  padding-bottom: 0.25em !important;
+  border-bottom: 1px solid #d8dee4;
+}
+
+section>h3 {
+  margin-top: 1em !important;
+  margin-bottom: 0.5em !important;
+}
+
+section>section>p {
+  margin-bottom: 0.5em !important;
+}
+
+section>ul.simple {
+  margin-bottom: 1em !important;
 }

docs/_templates/autosummary/base.rst

@@ -0,0 +1,5 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. auto{{ objtype }}:: {{ objname }}

docs/_templates/autosummary/class.rst

@@ -0,0 +1,39 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   {%- set ns = namespace(has_own_methods=false, has_own_attrs=false) -%}
+   {%- set exclude_members = ['__annotations_cache__', '__annotate_func__', '__doc__', '__format__', '__module__', '__new__', '__repr__', '_pybind11_conduit_v1_', '__pybind11_native_enum__'] -%}
+
+   {%- for item in members -%}
+      {%- if item not in attributes and
+            item not in inherited_members and
+            item not in exclude_members -%}
+         {%- set ns.has_own_methods = true -%}
+      {%- endif -%}
+      {%- if item in attributes and item not in inherited_members -%}
+         {%- set ns.has_own_attrs = true -%}
+      {%- endif -%}
+   {%- endfor -%}
+
+   {% block METHODS %}
+   {% if ns.has_own_methods %}
+   .. rubric:: {{ _('Methods') }}
+
+   .. autosummary::
+   {% for item in members %}
+   {% if item not in attributes and
+         item not in inherited_members and
+         item not in exclude_members %}
+      ~{{ name }}.{{ item }}
+   {% endif %}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block DESCRIPTION %}
+   {% if ns.has_own_methods %}
+   .. rubric:: {{ _('Member Documentation') }}
+   {% endif %}
+   {% endblock %}

docs/_templates/autosummary/module.rst

@@ -0,0 +1,47 @@
+{{ fullname | escape | underline}}
+
+.. automodule:: {{ fullname }}
+
+   {%- block exceptions %}
+   {% if exceptions %}
+   .. rubric:: {{ _('Exceptions') }}
+
+   .. autosummary::
+   {% for item in exceptions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {%- endblock %}
+
+   {%- block classes %}
+   {% if classes %}
+   .. rubric:: {{ _('Classes') }}
+
+   .. autosummary::
+   {% for item in classes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {%- endblock %}
+
+   {%- block functions %}
+   {% if functions %}
+   .. rubric:: {{ _('Functions') }}
+
+   .. autosummary::
+   {% for item in functions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {%- endblock %}
+
+   {%- block attributes %}
+   {% if attributes %}
+   .. rubric:: {{ _('Module Attributes') }}
+
+   .. autosummary::
+   {% for item in attributes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {%- endblock %}