Adding some narrative to version limits and consistency between requirements and tox configs

Author: bsipocz

.github/workflows/tests.yml

@@ -20,7 +20,7 @@ jobs:
       matrix:
         os: [ubuntu-latest]
         python-version: ["3.10", "3.11", "3.12", "3.13"]
-        sphinx: ["~=8.0"]
+        sphinx: ["~=8.0"]  # temporary limit, bring it back to newest sphinx once we are sphinx9 compatible
         myst-parser: [""]  # Newest MyST Parser (any)
         include:
           # Just check the other platforms once

tox.ini

@@ -16,9 +16,11 @@ envlist = py313-sphinx8
 [testenv]
 usedevelop = true
 
-[testenv:py{310,311,312,313}-sphinx{7,8}]
+[testenv:py{310,311,312,313}-sphinx{5,6,7,8}]
 extras = testing
 deps =
+    sphinx5: sphinx>=5,<6
+    sphinx6: sphinx>=6,<7
     sphinx7: sphinx>=7,<8
     sphinx8: sphinx>=8,<9
 commands = pytest {posargs}