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

22 beginner-friendly issues open

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
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
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
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
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
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
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
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
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
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
Specify lumache.py location at project root, in Getting started, doctests Open

type:bug

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

sphinx-doc/sphinx#13810 · Opened Aug 4, 2025
viewcode does not respect highlight_options Open

extensions:viewcode type:bug

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

sphinx-doc/sphinx#13303 · Opened Feb 5, 2025
Extension sphinxcontrib-htmlhelp has typo Open

awaiting:review type:bug

Difficulty 1/5 Under an hour Newbie friendliness 88/100

sphinx-doc/sphinx#12308 · 3 comments · Opened Apr 19, 2024
Incomplete documentation for add_js_file() and add_css_file() Open

awaiting:review easy type:bug type:docs

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

sphinx-doc/sphinx#12223 · 3 comments · 2 reactions · Opened Apr 2, 2024
Incorrect documentation for how to enable napoleon extension's `napoleon_type_aliases` setting Open

extensions:napoleon

Difficulty 1/5 Under an hour Newbie friendliness 75/100

sphinx-doc/sphinx#10963 · 4 reactions · Opened Nov 9, 2022
sphinx-build --help missing -M option Open

type:bug

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

sphinx-doc/sphinx#10618 · 1 comment · Opened Jun 30, 2022
sphinx-quickstart: Multiple --suffix Open

type:enhancement

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

sphinx-doc/sphinx#9510 · 2 comments · Opened Jul 29, 2021
Some themes do not import CSS from basic Open

good first issue help wanted html theme type:enhancement

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

sphinx-doc/sphinx#9093 · 2 comments · Opened Apr 12, 2021
DOC: Extensions options missing from sphinx-apidoc html docs Open

extensions:apidoc type:docs

Difficulty 1/5 1-3 hours Newbie friendliness 88/100

sphinx-doc/sphinx#8878 · 1 comment · Opened Feb 13, 2021
docs: Avoid unclear use of "attribute" Open

type:bug type:docs

Difficulty 1/5 Under an hour Newbie friendliness 78/100

sphinx-doc/sphinx#8358 · 3 comments · Opened Nov 1, 2020

sphinx-doc/sphinx

Get new issues in your inbox