Update readthedocs configuration (#93)

* update readthedocs python version
* add sphinx_rtd_theme requirement
* add sphinx.ext.napoleon
* remove html_static_path
* rename sphinx project
* update sphinx index

Author: vchrisb

.readthedocs.yaml

@@ -7,9 +7,9 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-  os: ubuntu-22.04
+  os: "ubuntu-22.04"
   tools:
-    python: "3.10"
+    python: "3.11"
     # You can also specify other tool versions:
     # nodejs: "19"
     # rust: "1.64"

docs/requirements.txt

@@ -1 +1,2 @@
 sphinx_mdinclude 
+sphinx_rtd_theme

docs/source/conf.py

@@ -6,7 +6,7 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project = "e3dc"
+project = "python-e3dc"
 copyright = "2023, see AUTHORS file"
 author = "see AUTHORS file"
 
@@ -20,6 +20,7 @@
     "sphinx.ext.autodoc",
     "sphinx_rtd_theme",
     "sphinx_mdinclude",
+    "sphinx.ext.napoleon",
 ]
 
 templates_path = ["_templates"]
@@ -31,7 +32,7 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_theme = "sphinx_rtd_theme"
-html_static_path = ["_static"]
+# html_static_path = ["_static"]
 
 # -- Options for todo extension ----------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/extensions/todo.html#configuration

docs/source/index.rst

@@ -1,9 +1,9 @@
-.. e3dc documentation master file, created by
+.. python-e3dc documentation master file, created by
    sphinx-quickstart on Sat Feb 11 10:32:00 2023.
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to e3dc's documentation!
+Welcome to python-e3dc's documentation!
 ================================
 
 .. mdinclude:: ../../README.md