sphinx-doc/sphinx

View on GitHub

The Sphinx documentation generator

Stars: 8k
Forks: 2.6k
Open beginner issues: 10
Indexed issues: 1.2k

Dominant language: Python
License: No license data
Last GitHub push: Sep 18, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: help wanted good first issue
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

1,196 open issues indexed

test_connect_to_selfsigned_fails can time out before certificate verification Open

type:bug

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

sphinx-doc/sphinx#14699 · Opened Sep 19, 2026
Python domain: only the first nested object inherits the class prefix inside a non-nestable directive body Open

type:bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

sphinx-doc/sphinx#14694 · Opened Sep 18, 2026
Some tests depend on execution order and inherited color environment variables Open

type:bug

Difficulty 3/5 1-2 days Newbie friendliness 76/100

sphinx-doc/sphinx#14690 · Opened Sep 18, 2026
Autodoc displays `enum.Flag` member unions poorly when they are class attributes Open

type:bug

Difficulty 3/5 1-2 days Newbie friendliness 58/100

sphinx-doc/sphinx#14688 · Opened Sep 16, 2026
Docutils 1.0 development changes break native doctests and table widths Open

docutils type:bug

Difficulty 4/5 3-5 days Newbie friendliness 62/100

sphinx-doc/sphinx#14680 · 2 comments · Opened Sep 13, 2026
test_html_rebuild_mo can fail after a slow build Open

type:bug type:tests

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

sphinx-doc/sphinx#14678 · Opened Sep 13, 2026
sphinx.ext.viewcode generates a module page with no source links Open

extensions:viewcode type:bug

Difficulty 3/5 1-2 days Newbie friendliness 58/100

sphinx-doc/sphinx#14675 · Opened Sep 13, 2026
Damaged format placeholders in the el and fa catalogues abort the build instead of warning Open

type:bug

Difficulty 4/5 3-5 days Newbie friendliness 45/100

sphinx-doc/sphinx#14664 · 4 comments · Opened Sep 1, 2026
Use canonical URL for RFCs Open

type:bug

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

sphinx-doc/sphinx#14659 · Opened Aug 30, 2026
TypeError(f'{name!r} is a field but has no type annotation') Open

type:bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

sphinx-doc/sphinx#14656 · 3 comments · Opened Aug 29, 2026
Bad display of annotated enum members Open

type:bug

Difficulty 3/5 1-2 days Newbie friendliness 64/100

sphinx-doc/sphinx#14653 · Opened Aug 28, 2026
TOML Inventories Open

type:proposal

Difficulty 5/5 Over a week Newbie friendliness 35/100

sphinx-doc/sphinx#14650 · 2 comments · Opened Aug 26, 2026
Reading mode for pages Open

html theme type:proposal

Difficulty 5/5 Over a week Newbie friendliness 30/100

sphinx-doc/sphinx#14645 · Opened Aug 25, 2026
"empty glob" warnings cannot be suppressed. Open

type:bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

sphinx-doc/sphinx#14625 · Opened Aug 20, 2026
`todolist` produce duplicate titles for admonitions Open

extensions:todo type:bug

Difficulty 3/5 1-2 days Newbie friendliness 72/100

sphinx-doc/sphinx#14623 · Opened Aug 19, 2026
`autodoc` fails with `AttributeError` when importing SQLAlchemy models split across multiple files Open

extensions:autodoc type:bug

Difficulty 4/5 3-5 days Newbie friendliness 52/100

sphinx-doc/sphinx#14618 · 1 comment · Opened Aug 19, 2026
Using `add_node` and `dirhtml` causes nodes from `sphinx.ext` to become unknown Open

type:bug

Difficulty 3/5 1-2 days Newbie friendliness 66/100

sphinx-doc/sphinx#14587 · 1 comment · Opened Aug 7, 2026
autodoc: IndexError formatting signature for callable data object with annotated class variable Open

extensions:autodoc type:bug

Difficulty 2/5 1-3 hours Newbie friendliness 74/100

sphinx-doc/sphinx#14576 · 2 comments · Opened Aug 1, 2026
Mismatch between --no-color and NO_COLOR behavior in Sphinx 9.1.0 on Windows Open

type:bug

Difficulty 3/5 1-2 days Newbie friendliness 55/100

sphinx-doc/sphinx#14565 · 2 comments · Opened Jul 30, 2026
`:py:deco:` and `:py:const:` roles resolve locally but never through intersphinx Open

domains:py extensions:intersphinx type:bug

Difficulty 3/5 1-2 days Newbie friendliness 78/100

sphinx-doc/sphinx#14564 · 1 reaction · Opened Jul 30, 2026
autodoc-skip-member documentation is incorrect Open

extensions:autodoc extensions:autosummary type:bug type:docs

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

sphinx-doc/sphinx#14555 · 2 comments · Opened Jul 25, 2026
sphinx-build prints long message and traceback info for ExtensionError and ConfigError exceptions (regression) Open

api:cmdline type:bug

Difficulty 3/5 1-2 days Newbie friendliness 65/100

sphinx-doc/sphinx#14543 · 2 comments · Opened Jul 20, 2026
linkcheck reports existing local files as broken when URI contains query or fragment Open

builder:linkcheck type:bug

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

sphinx-doc/sphinx#14542 · 1 comment · Opened Jul 20, 2026
linkcheck reports uppercase-scheme URIs as broken Open

builder:linkcheck type:bug

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

sphinx-doc/sphinx#14541 · 5 comments · Opened Jul 20, 2026
Nested dictionaries/lists not supported by `sphinx-build --define` Open

api:cmdline type:docs

Difficulty 3/5 1-2 days Newbie friendliness 65/100

sphinx-doc/sphinx#14539 · 4 comments · Opened Jul 19, 2026
Autodoc: Document `SPHINX_AUTODOC_IGNORE_NATIVE_MODULE_TYPE_STUBS` variable added in v9.1.0 Open

extensions:autodoc type:proposal

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

sphinx-doc/sphinx#14528 · Opened Jul 12, 2026
autodoc-skip-member throws exception -- Pydantic Open

extensions:napoleon type:bug

Difficulty 4/5 3-5 days Newbie friendliness 38/100

sphinx-doc/sphinx#14524 · Opened Jul 8, 2026
Regression with Sphinx 8 and symlinks: `document isn't included in any toctree [toc.not_included]` Open

internals:toctree type:bug

Difficulty 3/5 1-2 days Newbie friendliness 55/100

sphinx-doc/sphinx#14520 · 2 comments · Opened Jul 6, 2026
Napoleon skips documentend speical members even with napoleon_include_special_with_doc=True Open

extensions:napoleon type:bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

sphinx-doc/sphinx#14515 · Opened Jul 2, 2026
KeyError: 'refuri' in _resolve_toctree when rendering pages outside the conf.py directory (monorepo setup) Open

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

sphinx-doc/sphinx#14514 · 1 comment · Opened Jul 1, 2026
test_gettext_literalblock_additional: Assertion that literalblock.pot exists fails in the parallel test run in Fedora Linux Open

type:bug

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

sphinx-doc/sphinx#14506 · 1 comment · Opened Jun 29, 2026
autodoc `show-inheritance` emits dangling `py:obj` xref for a TypeVar in a `Generic[...]` base (nitpicky) Open

extensions:autodoc

Difficulty 3/5 1-2 days Newbie friendliness 68/100

sphinx-doc/sphinx#14502 · Opened Jun 25, 2026
9.1.1 Release plan Open

type:task

Difficulty 5/5 Over a week Newbie friendliness 25/100

sphinx-doc/sphinx#14501 · 8 comments · 6 reactions · Opened Jun 25, 2026
Sporadic Sphinx parallel build error - unbound local variable "line" Open

awaiting:review internals:parallel type:bug

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

sphinx-doc/sphinx#14466 · Opened Jun 4, 2026
Type variables flagged as undefined with ref.class warning spuriously in nitpicky mode Open

type:bug

Difficulty 3/5 1-2 days Newbie friendliness 52/100

sphinx-doc/sphinx#14462 · 1 comment · Opened Jun 1, 2026
EOFError in parallel builds due to `logging.convert_serializable` Open

internals:parallel type:bug

Difficulty 4/5 3-5 days Newbie friendliness 42/100

sphinx-doc/sphinx#14458 · 3 comments · Opened May 29, 2026
sphinx.ext.autodoc | TYPE_CHECKING | Mapping/Callable show `__annotationlib_name_n__` types instead of e.g. `str` Open

3.14 extensions:autodoc type:bug

Difficulty 4/5 3-5 days Newbie friendliness 48/100

sphinx-doc/sphinx#14457 · Opened May 29, 2026
docutils 0.23 released; please update Sphinx dependency Open

docutils type:proposal

Difficulty 3/5 1-2 days Newbie friendliness 68/100

sphinx-doc/sphinx#14455 · 5 comments · 11 reactions · Opened May 28, 2026
literalinclude directive: support negative indexing Open

type:proposal

Difficulty 3/5 1-2 days Newbie friendliness 45/100

sphinx-doc/sphinx#14453 · 3 comments · Opened May 28, 2026
linkcheck_allowed_redirects does not support dynamic backreference substitution in redirect validation Open

builder:linkcheck type:proposal

Difficulty 3/5 1-2 days Newbie friendliness 64/100

sphinx-doc/sphinx#14450 · Opened May 26, 2026
Intersphinx SSL certificate issue on Amazon Linux 2023 (WSL only) Open

extensions:intersphinx type:bug

Difficulty 4/5 3-5 days Newbie friendliness 45/100

sphinx-doc/sphinx#14435 · 1 comment · Opened May 18, 2026
Bad references in man pages Open

builder:manpage type:bug

Difficulty 4/5 3-5 days Newbie friendliness 55/100

sphinx-doc/sphinx#14427 · 3 comments · Opened May 11, 2026
Local variable "sitedir" is not defined since Python 3.15.0-beta.1 Open

3.15 extensions:mathematics type:bug

Difficulty 3/5 1-2 days Newbie friendliness 55/100

sphinx-doc/sphinx#14426 · 8 comments · 3 reactions · Opened May 10, 2026
Marking experimental/unstable github actions as such Open

type:proposal

Difficulty 3/5 1-2 days Newbie friendliness 58/100

sphinx-doc/sphinx#14425 · Opened May 7, 2026
code directive doesn't treat emphasize-lines option the same way as code-block Open

type:docs

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

sphinx-doc/sphinx#14411 · 3 comments · Opened Apr 22, 2026
`genindex.html`: have linked name + separate qualifier Open

type:proposal

Difficulty 3/5 1-2 days Newbie friendliness 55/100

sphinx-doc/sphinx#14390 · 1 comment · Opened Apr 12, 2026
Removal of parser.set_application breaks parser Open

type:bug

Difficulty 4/5 3-5 days Newbie friendliness 42/100

sphinx-doc/sphinx#14371 · 2 comments · Opened Apr 5, 2026
Encoding error when cloning the repo Open

type:bug

Difficulty 2/5 1-3 hours Newbie friendliness 25/100

sphinx-doc/sphinx#14364 · 3 comments · 1 reaction · Opened Apr 1, 2026
graphviz warnings are silently discarded Open

extensions:graphviz type:bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

sphinx-doc/sphinx#14362 · Opened Mar 30, 2026
graphviz errors are reported only once and obsolete graphs are left behind Open

extensions:graphviz type:bug

Difficulty 4/5 3-5 days Newbie friendliness 55/100

sphinx-doc/sphinx#14361 · 2 comments · Opened Mar 30, 2026

sphinx-doc/sphinx

Get new issues in your inbox