Refactor and clean-up C++ API docs (#175)

* Refactor and clean-up C++ API docs

* Remove port specification from livehtml target in Makefile

Author: zfergus

docs/Makefile

@@ -23,5 +23,8 @@ clean:
 %: Makefile
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
+xml:
+	cd "$(SOURCEDIR)" && doxygen Doxyfile
+
 livehtml:
-	sphinx-autobuild --host 0.0.0.0 "$(SOURCEDIR)" "$(BUILDDIR)/html" $(SPHINXOPTS) $(O)
+	sphinx-autobuild --host 0.0.0.0 -j auto -a -q "$(SOURCEDIR)" "$(BUILDDIR)/html" $(SPHINXOPTS) $(O)

docs/source/_static/css/custom.css

@@ -17,6 +17,10 @@ span.colon {
     margin-left: -1em;
 }
 
+dl.cpp {
+    font-size: 0.64rem;
+}
+
 dl.cpp.objdesc,
 dl.py.objdesc {
     /* border: 0.05rem solid var(--md-primary-fg-color); */
@@ -28,6 +32,7 @@ dl.py.objdesc {
 
 dl.cpp.objdesc>dt,
 dl.py.objdesc>dt {
+    font-size: 0.64rem;
     padding-left: 0.5rem;
     padding-right: 0.5rem;
 }

docs/source/dependencies.rst docs/source/about/dependencies.rstdocs/source/dependencies.rst renamed to docs/source/about/dependencies.rst

@@ -4,7 +4,7 @@ License
 
 IPC Toolkit is released under an MIT license, and all of its dependencies are under similar permissive licenses (MIT, Apache, or MPL).
 
-.. literalinclude:: ../../LICENSE
+.. literalinclude:: ../../../LICENSE
     :language: md
 
 Citation

docs/source/license.rst docs/source/about/license.rstdocs/source/license.rst renamed to docs/source/about/license.rst

@@ -1,6 +1,6 @@
 Python Bindings
 ===============
 
-.. include:: ../../python/README.md
+.. include:: ../../../python/README.md
     :parser: myst_parser.sphinx_
     :start-line: 10

docs/source/release_notes.rst docs/source/about/release_notes.rstdocs/source/release_notes.rst renamed to docs/source/about/release_notes.rst

@@ -101,7 +101,7 @@
     "private-members",
 )
 breathe_show_define_initializer = True
-# breathe_show_include = True
+breathe_show_include = True
 
 autodoc_default_options = {
     "members": True,
@@ -176,14 +176,14 @@
     "icon": {"repo": "fontawesome/brands/github"},
 
     "features": [
-        "navigation.expand",
+        "content.tabs.link",
+        "navigation.footer",
         "navigation.tabs",
         "navigation.top",
         "navigation.tracking",
         "search.highlight",
         "search.share",
         "toc.follow",
-        "content.tabs.link"
     ],
 
     "font": {