Update Read the Docs configuration and remove obsolete reference documentation

Author: bltravis

.readthedocs.yml

@@ -4,6 +4,13 @@
 
 version: 2
 
+sphinx:
+  configuration: docs/source/conf.py
+  fail_on_warning: false
+
+formats:
+  - htmlzip
+
 build:
   os: ubuntu-22.04
   tools:
@@ -14,10 +21,3 @@ python:
     - method: pip
       path: .
     - requirements: docs/requirements.txt
-
-sphinx:
-  configuration: docs/conf.py
-  fail_on_warning: false
-
-formats:
-  - htmlzip

docs/reference.rst

@@ -15,6 +15,7 @@ The core module for batch posting inventory records to FOLIO.
    :members:
    :undoc-members:
    :show-inheritance:
+   :noindex:
 
 MARCDataImport
 ~~~~~~~~~~~~~~
@@ -25,6 +26,7 @@ Module for importing MARC records using FOLIO's Data Import APIs.
    :members:
    :undoc-members:
    :show-inheritance:
+   :noindex:
 
 UserImport
 ~~~~~~~~~~
@@ -35,6 +37,7 @@ Module for importing user data into FOLIO.
    :members:
    :undoc-members:
    :show-inheritance:
+   :noindex:
 
 Custom Exceptions
 ~~~~~~~~~~~~~~~~~
@@ -45,6 +48,7 @@ Exception classes used throughout the toolkit.
    :members:
    :undoc-members:
    :show-inheritance:
+   :noindex:
 
 Progress Reporting
 ~~~~~~~~~~~~~~~~~~
@@ -55,6 +59,7 @@ Progress tracking and reporting utilities.
    :members:
    :undoc-members:
    :show-inheritance:
+   :noindex:
 
 MARC Preprocessors
 ~~~~~~~~~~~~~~~~~~
@@ -65,6 +70,7 @@ MARC record preprocessor functions.
    :members:
    :undoc-members:
    :show-inheritance:
+   :noindex:
 
 See Also
 --------

docs/source/api_reference.rst

@@ -0,0 +1,66 @@
+# docs/conf.py
+import datetime
+import os
+import sys
+
+"""Sphinx configuration."""
+project = "FOLIO Data Import"
+author = "EBSCO Information Services"
+copyright = f"{datetime.date.today().year}, {author}"
+
+# Path setup - add the source directory to sys.path
+sys.path.insert(0, os.path.abspath("../src"))
+
+# Master document
+master_doc = "index"
+
+extensions = [
+    "myst_parser",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.napoleon",
+    "sphinx_autodoc_typehints",
+    "sphinx_design",
+]
+
+# Napoleon settings for Google-style docstrings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_init_with_doc = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = True
+napoleon_use_admonition_for_notes = True
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
+napoleon_preprocess_types = True
+html_theme = "sphinx_book_theme"
+myst_heading_anchors = 3
+html_theme_options = {
+    "repository_url": "https://github.com/folio-fse/folio_data_import",
+    "use_repository_button": True,
+    "show_navbar_depth": 2,
+    "max_navbar_depth": 3,
+    "show_nav_level": 2,
+    "collapse_navigation": True,
+}
+myst_enable_extensions = [
+    "deflist",
+    "colon_fence",
+]
+
+# Autodoc settings
+autodoc_default_options = {
+    "members": True,
+    "undoc-members": True,
+    "show-inheritance": True,
+}
+autodoc_member_order = "bysource"
+
+source_suffix = {
+    ".rst": "restructuredtext",
+    ".txt": "markdown",
+    ".md": "markdown",
+}