Unpin docs dependencies

.circleci/config.yml

@@ -7,12 +7,6 @@ commands:
       python-version:
         type: string
     steps:
-      - restore_cache:
-          keys:
-            - cache_v5-wayback-<< parameters.python-version >>-{{ arch }}-{{ checksum "requirements.txt" }}-{{ checksum "requirements-dev.txt" }}
-            - cache_v5-wayback-<< parameters.python-version >>-{{ arch }}-{{ checksum "requirements.txt" }}-
-            - cache_v5-wayback-<< parameters.python-version >>-{{ arch }}-
-
       - run:
           name: Install Dependencies
           command: |
@@ -23,11 +17,6 @@ commands:
             pip install .
             pip install -r requirements-dev.txt  # extra requirements for tests, docs
 
-      - save_cache:
-          key: cache_v5-wayback-<< parameters.python-version >>-{{ arch }}-{{ checksum "requirements.txt" }}-{{ checksum "requirements-dev.txt" }}
-          paths:
-            - ~/venv
-
 jobs:
   test:
     parameters:
@@ -95,11 +84,11 @@ jobs:
   docs:
     working_directory: ~/wayback
     docker:
-      - image: cimg/python:3.8
+      - image: cimg/python:3.10
     steps:
       - checkout
       - setup_pip:
-          python-version: "3.8"
+          python-version: "3.10"
       - run:
           name: Build docs
           command: |

docs/source/conf.py

@@ -17,9 +17,9 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
+import os
+import sys
+sys.path.insert(0, os.path.abspath('../..'))
 
 
 # -- General configuration ------------------------------------------------
@@ -81,7 +81,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -90,7 +90,7 @@
 
 # Set up link shortcuts
 extlinks = {
-    'issue': ('https://github.com/edgi-govdata-archiving/wayback/issues/%s', '#'),
+    'issue': ('https://github.com/edgi-govdata-archiving/wayback/issues/%s', 'issue %s'),
 }
 
 # The name of the Pygments (syntax highlighting) style to use.

requirements-dev.txt

@@ -7,11 +7,14 @@ coverage
 flake8
 requests-mock
 pytest
-sphinx ~=3.1.1
+
+# remove pin after https://github.com/readthedocs/sphinx_rtd_theme/issues/1343 closes
+sphinx!=5.2.0.post0
+
 vcrpy
 twine
 # These are dependencies of various sphinx extensions for documentation.
 ipython
-numpydoc ~=1.0.0
-sphinx-copybutton ~=0.2.12
-sphinx_rtd_theme ~=0.5.0
+numpydoc
+sphinx-copybutton
+sphinx_rtd_theme