Remove sphinx-apidoc generation from docs build

- Reorder docs
- Make clean ignore missing folder

docs/Makefile

@@ -29,7 +29,7 @@ customdefault:
 all: html
 
 clean:
-	rm -r $(BUILDDIR)
+	rm -rf $(BUILDDIR)
 
 html:
 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html

docs/source/apidoc/janus_core.rst

@@ -1,6 +1,16 @@
 janus\_core package
 ===================
 
+Module contents
+---------------
+
+.. automodule:: janus_core
+   :members:
+   :special-members:
+   :private-members:
+   :undoc-members:
+   :show-inheritance:
+
 Submodules
 ----------
 
@@ -43,13 +53,3 @@ janus\_core.single\_point module
    :private-members:
    :undoc-members:
    :show-inheritance:
-
-Module contents
----------------
-
-.. automodule:: janus_core
-   :members:
-   :special-members:
-   :private-members:
-   :undoc-members:
-   :show-inheritance:

docs/source/conf.py

@@ -186,48 +186,3 @@
 nitpick_ignore = [
     ("py:class", "Logger"),
 ]
-
-
-def run_apidoc(_):
-    """Runs sphinx-apidoc when building the documentation.
-
-    Needs to be done in conf.py in order to include the APIdoc in the
-    build on readthedocs.
-
-    See also https://github.com/rtfd/readthedocs.org/issues/1139
-    """
-    source_dir = os.path.abspath(os.path.dirname(__file__))
-    apidoc_dir = os.path.join(source_dir, "apidoc")
-    package_dir = os.path.join(source_dir, os.pardir, os.pardir, "janus_core")
-
-    # In #1139, they suggest the route below, but this ended up
-    # calling sphinx-build, not sphinx-apidoc
-    # from sphinx.apidoc import main
-    # main([None, '-e', '-o', apidoc_dir, package_dir, '--force'])
-
-    import subprocess
-
-    cmd_path = "sphinx-apidoc"
-    if hasattr(sys, "real_prefix"):  # Check to see if we are in a virtualenv
-        # If we are, assemble the path manually
-        cmd_path = os.path.abspath(os.path.join(sys.prefix, "bin", "sphinx-apidoc"))
-
-    options = [
-        "-o",
-        apidoc_dir,
-        package_dir,
-        "--private",
-        "--force",
-        "--no-toc",
-    ]
-
-    # See https://stackoverflow.com/a/30144019
-    env = os.environ.copy()
-    env["SPHINX_APIDOC_OPTIONS"] = (
-        "members,special-members,private-members,undoc-members,show-inheritance"
-    )
-    subprocess.check_call([cmd_path] + options, env=env)
-
-
-def setup(app):
-    app.connect("builder-inited", run_apidoc)