Fix RTD and modernize workflows (#58)

* DOC: Fix RTD.

* TST: Modernize workflows.

* RTD: Ignore warnings

* TST: use astropy wheel

.github/workflows/ci_workflows.yml

@@ -43,7 +43,7 @@ jobs:
     needs: initial_check
     steps:
     - name: Checkout code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         fetch-depth: 0
     - name: Set up Python
@@ -71,7 +71,7 @@ jobs:
     needs: initial_check
     steps:
     - name: Checkout code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         fetch-depth: 0
     - name: Set up Python
@@ -91,7 +91,7 @@ jobs:
     needs: [pep_and_audit, initial_tests]
     steps:
     - name: Checkout code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         fetch-depth: 0
     - name: Set up Python
@@ -101,18 +101,18 @@ jobs:
     - name: Install and build
       run: |
         python -m pip install --upgrade pip setuptools
-        python -m pip install git+https://github.com/astropy/astropy.git@main#egg=astropy
+        python -m pip install --extra-index-url https://pypi.anaconda.org/astropy/simple astropy>=0.0.dev0 --pre --upgrade
         python -m pip install -e .[test]
     - name: Test with dev deps
       run: pytest
 
   old_deps_tests:
     name: CI with old dependencies
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-20.04
     needs: [pep_and_audit, initial_tests]
     steps:
     - name: Checkout code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         fetch-depth: 0
     - name: Set up Python
@@ -137,7 +137,7 @@ jobs:
         os: [windows-latest, macos-latest]
     steps:
     - name: Checkout code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         fetch-depth: 0
     - name: Set up Python
@@ -157,7 +157,7 @@ jobs:
     needs: [pep_and_audit, initial_tests]
     steps:
     - name: Checkout code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
     - name: Set up Python
       uses: actions/setup-python@v4
       with:

.github/workflows/codeql-analysis.yml

@@ -37,7 +37,7 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL

.github/workflows/predeps_workflow.yml

@@ -18,13 +18,13 @@ jobs:
         os: [ubuntu-latest, windows-latest, macos-latest]
     steps:
     - name: Checkout code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
       with:
         fetch-depth: 0
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
-        python-version: '3.10'
+        python-version: '3.11'
     - name: Install and build
       run: |
         python -m pip install --upgrade pip setuptools

.github/workflows/publish-to-pypi.yml

@@ -19,7 +19,7 @@ jobs:
 
           # Check out the commit containing this workflow file.
           - name: checkout repo
-            uses: actions/checkout@v3
+            uses: actions/checkout@v4
 
           - name: custom action
             uses: spacetelescope/action-publish_to_pypi@master

.readthedocs.yml

@@ -3,20 +3,19 @@
 version: 2
 
 build:
-  os: ubuntu-20.04
+  os: ubuntu-22.04
   apt_packages:
     - graphviz
   tools:
-    python: "3.9"
+    python: "3.11"
 
 sphinx:
   builder: html
   configuration: doc/source/conf.py
-  fail_on_warning: true
+  fail_on_warning: false
 
 # Set the version of Python and requirements required to build your docs
 python:
-  system_packages: false
   install:
     - method: pip
       path: .

doc/source/conf.py

@@ -27,7 +27,7 @@
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.autosummary',
-    'sphinx.ext.napoleon',
+    'numpydoc',
     'sphinx.ext.intersphinx',
     'sphinx.ext.imgmath']
 

setup.cfg

@@ -42,6 +42,8 @@ test =
     pytest-remotedata
     pytest-astropy-header
 docs =
+    sphinx<7
+    numpydoc
     sphinx_rtd_theme
 
 [options.package_data]