Remove duplicate doc build, doc config clean ups (#604)

* Modernize RTD config

* Delete .gitmodules

* Update MANIFEST.in

* Delete docs/rtd-pip-requirements

* Update conf.py

* Remove build_docs from ci_tests.yml

Author: pllim

.github/workflows/ci_tests.yml

@@ -58,11 +58,6 @@ jobs:
             python: '3.11'
             toxenv: py11-test-devdeps
 
-          - name: Test building of Sphinx docs
-            os: ubuntu-latest
-            python: 3.x
-            toxenv: build_docs
-
     steps:
     - name: Checkout code
       uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4.2.2

.gitmodules

@@ -0,0 +1,26 @@
+version: 2
+
+build:
+  os: "ubuntu-22.04"
+  apt_packages:
+    - graphviz
+  tools:
+    python: "3.11"
+
+sphinx:
+  builder: html
+  configuration: docs/conf.py
+  fail_on_warning: true
+
+# Install regular dependencies.
+# Then, install special pinning for RTD.
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
+
+# Optionally build your docs in additional formats such as PDF
+formats:
+   - pdf

.readthedocs.yaml

@@ -2,15 +2,11 @@ include LICENSE.rst
 include README.rst
 include CHANGES.rst
 
-include ez_setup.py
-include ah_bootstrap.py
+include pyproject.toml
 include setup.cfg
 
-recursive-include *.pyx *.c *.pxd
 recursive-include docs *
 recursive-include licenses *
-recursive-include cextern *
-recursive-include scripts *
 
 prune build
 prune docs/_build

.readthedocs.yml

@@ -64,12 +64,6 @@
 copyright = '{0}, {1}'.format(
     datetime.datetime.now().year, setup_cfg['author'])
 
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-__import__(project)
-package = sys.modules[project]
-
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
@@ -166,8 +160,7 @@
 ]
 
 # -- Resolving issue number to links in changelog -----------------------------
-github_issues_url = 'https://github.com/{0}/issues/'.format(setup_cfg['github_p\
-roject'])
+github_issues_url = 'https://github.com/astropy/astroplan/issues/'
 
 # -- Options for linkcheck output -------------------------------------------
 linkcheck_retry = 5