Mic 4180/doc builds (#317)

Mic-4180/doc builds

Update for docs to work successfully.
- *Category*: Documentation
- *JIRA issue*: [MIC-4180](https://jira.ihme.washington.edu/browse/MIC-4180)

Changes and notes
-update readthedocs yml
-pin sphinx below 7.0
-update doctest

Testing
Doctest pass and no build failures.

.github/workflows/build.yml

@@ -103,10 +103,9 @@ jobs:
       - name: Test
         run: |
           pytest ./tests
-#      Commenting out docs build due to upstream failures: MIC-4180
-#      - name: Doc build
-#        run: |
-#          make html -C docs/ SPHINXOPTS="-W --keep-going -n"
-#      - name: Doctest
-#        run: |
-#          make doctest -C docs/
+      - name: Doc build
+        run: |
+          make html -C docs/ SPHINXOPTS="-W --keep-going -n"
+      - name: Doctest
+        run: |
+          make doctest -C docs/

.readthedocs.yml

@@ -4,8 +4,11 @@ version: 2
 
 # Configure the python version and environment construction run before
 # docs are built.
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
 python:
-  version: 3.8
   install:
       # This runs pip install .[docs] from the project root.
     - method: pip

docs/source/tutorials/pulling_data.rst

@@ -376,7 +376,12 @@ To use:
     from gbd_mapping import ModelableEntity
 
     funcs = {get_measure: {
-                'parameters': {'entity': ModelableEntity, 'measure': str, 'location': str},
+                'parameters': {
+                    'entity': ModelableEntity, 
+                    'measure': str, 
+                    'location': str, 
+                    'get_draws_kwargs': inspect._empty,
+                        },
                 'return': pd.DataFrame, },
              get_population_structure: {
                  'parameters': {'location': str},

setup.py

@@ -37,7 +37,7 @@
     ]
 
     doc_requirements = [
-        "sphinx>=4.0",
+        "sphinx<7.0",
         "sphinx-rtd-theme",
     ]