👷 [maykinmedia/open-api-framework#92] Make sure docs are built in CI

.github/workflows/ci.yml

@@ -118,13 +118,15 @@ jobs:
         id: image-name
 
   open-api-ci:
-    uses: maykinmedia/open-api-workflows/.github/workflows/ci.yml@v1
+    uses: maykinmedia/open-api-workflows/.github/workflows/ci.yml@v3.0.2
     needs:
       - store-reusable-workflow-vars
     with:
       main-branch: 'master'
+      run-docs: true
       python-version: '3.11'
       docker-image-name: ${{ needs.store-reusable-workflow-vars.outputs.image-name }}
+      django-settings-module: openklant.conf.ci
 
   open-api-publish:
     uses: maykinmedia/open-api-workflows/.github/workflows/publish.yml@v1

docs/conf.py

@@ -66,18 +66,19 @@
         "https://docs.python-requests.org/en/latest/",
         None,
     ),
-    "django": (
-        "http://docs.djangoproject.com/en/3.2/",
-        "http://docs.djangoproject.com/en/3.2/_objects/",
-    ),
+    # FIXME this is raising errors "not readable due to ValueError: I/O operation on closed file."
+    # "django": (
+    #     "http://docs.djangoproject.com/en/4.2/",
+    #     "http://docs.djangoproject.com/en/4.2/_objects/",
+    # ),
 }
 
 # -- Options for HTML output -------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_logo = "logo.svg"
+# html_logo = "logo.svg"
 html_theme = "sphinx_rtd_theme"
 
 # Add any paths that contain custom static files (such as style sheets) here,
@@ -90,6 +91,8 @@
 
 todo_include_todos = True
 
+linkcheck_retries = 3
+
 linkcheck_ignore = [
     r"urn:*",
     r"https?://.*\.gemeente.nl",