numpy/numpydoc

View on GitHub

Numpy's Sphinx extensions

Stars: 355
Forks: 181
Open beginner issues: 0
Indexed issues: 109
Avg merge: 1d 9h
Merged PRs (30d): 3

Dominant language: Python
License: No license data
Last GitHub push: Sep 15, 2026
Latest indexed: Sep 20, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted

Beginner friendly Everything

Open All

109 open issues indexed

numpydoc Open

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

numpy/numpydoc#694 · Opened Jun 8, 2026
Proposal to create Markdown equivalent of specification Open

needs-decision

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

numpy/numpydoc#692 · 5 reactions · Opened May 29, 2026
Add built-in validation check for bullet lists missing a preceding blank line Open

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

numpy/numpydoc#686 · 1 comment · 1 reaction · Opened May 1, 2026
ExceptionGroup handling Open

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

numpy/numpydoc#684 · 1 comment · Opened Apr 30, 2026
Warn on improperly formatted parameter definitions Open

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

numpy/numpydoc#677 · 4 comments · Opened Jan 28, 2026
Style guide diverges from "Single-Source-of-Truth" regarding function parameter type documentation Open

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

numpy/numpydoc#664 · 5 comments · Opened Nov 19, 2025
"Make sure CLI works" job in `test.yml` has an exception that doesn't cause the job to fail Open

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

numpy/numpydoc#661 · 2 comments · Opened Nov 13, 2025
Return type annotation is collapsed when no name is given Open

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

numpy/numpydoc#659 · Opened Nov 13, 2025
Broken codecov setup Open

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

numpy/numpydoc#656 · 1 reaction · Opened Oct 21, 2025
Make sphinx a soft dependency or factor out docstring parsing Open

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

numpy/numpydoc#648 · 2 comments · 2 reactions · Opened Oct 6, 2025
Linter PR01 and PR02 for functions using arbitrary keyword arguments `**kwargs` Open

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

numpy/numpydoc#645 · Opened Sep 2, 2025
Improve support for modules/packages Open

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

numpy/numpydoc#643 · Opened Aug 31, 2025
Failure to parse docstrings where a section contains header-like content Open

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

numpy/numpydoc#640 · 1 comment · Opened Jul 23, 2025
Is it possible to skip specific rules for specific functions? Open

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

numpy/numpydoc#636 · Opened Jun 26, 2025
NumPy NDArray typing conflict with numpydoc for `np.integer`. Open

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

numpy/numpydoc#633 · Opened Jun 24, 2025
`FunctionDoc` round-trip strips empty lines from Parameters and breaks doctest Open

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

numpy/numpydoc#624 · Opened May 16, 2025
RFC: split `docscrape` out into separate repo Open

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

numpy/numpydoc#619 · 3 comments · 1 reaction · Opened Apr 26, 2025
Non-functions in the `See Also` section Open

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

numpy/numpydoc#618 · Opened Apr 16, 2025
Feature Request: Support for Standalone numpydoc.toml Configuration File Open

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

numpy/numpydoc#617 · 1 comment · 4 reactions · Opened Apr 14, 2025
How should class variables be documented? Open

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

numpy/numpydoc#612 · Opened Mar 10, 2025
Array API Compatibility as a separate section? Open

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

numpy/numpydoc#610 · 1 comment · Opened Mar 3, 2025
Reconsider position of Attributes and Methods sections Open

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

numpy/numpydoc#608 · 4 comments · Opened Feb 24, 2025
Feature request: Add support for dataclasses Open

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

numpy/numpydoc#604 · 3 comments · 2 reactions · Opened Feb 3, 2025
Allow multiple `Warning(s)` sections Open

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

numpy/numpydoc#594 · 11 comments · Opened Dec 15, 2024
Check GL08 on class __init__ constructors Open

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

numpy/numpydoc#591 · 7 comments · 2 reactions · Opened Dec 9, 2024
Lots of UserWarnings for Unknown Section despite GL06 rule exemption Open

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

numpy/numpydoc#589 · 1 comment · Opened Nov 8, 2024
Parse error when attempting to document a type alias `MapType = dict[str, float]` Open

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

numpy/numpydoc#587 · Opened Oct 18, 2024
Add Methods rubric header even without listing a table Open

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

numpy/numpydoc#584 · Opened Oct 11, 2024
Feature Request: ignore @overload decorated objects Open

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

numpy/numpydoc#559 · 1 comment · 5 reactions · Opened May 22, 2024
Fix and test BadExamples Open

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

numpy/numpydoc#557 · Opened May 11, 2024
Add numpydoc/tests/hooks to manifest Open

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

numpy/numpydoc#556 · Opened May 11, 2024
`Validator.method_source` returns `""` for `property` and `cached_property` Open

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

numpy/numpydoc#551 · 1 comment · Opened May 7, 2024
UnicodeDecodeError Open

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

numpy/numpydoc#546 · 2 comments · Opened Apr 27, 2024
Anybody having issues with sphinx-autoapi? Open

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

numpy/numpydoc#528 · Opened Feb 15, 2024
BUG: Object references that start with a tilde in "See Also" section cause a `ValueError` Open

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

numpy/numpydoc#519 · 3 comments · Opened Dec 22, 2023
"Handler <function mangle_docstrings at 0x7f64b5ba57b8> for event 'autodoc-process-docstring' threw an exception" again Open

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

numpy/numpydoc#511 · 1 comment · 2 reactions · Opened Oct 20, 2023
Add built-in validation checks for directive syntax Open

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

numpy/numpydoc#507 · 1 comment · 1 reaction · Opened Sep 27, 2023
Integration into Sphinx Open

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

numpy/numpydoc#503 · 2 reactions · Opened Sep 21, 2023
Support typing[_extensions].Doc Open

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

numpy/numpydoc#502 · Opened Sep 18, 2023
Exclude Files in Test Modules from Numpydoc Validation Open

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

numpy/numpydoc#497 · 11 reactions · Opened Aug 24, 2023
Numpydoc validation - ignore setters Open

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

numpy/numpydoc#494 · Opened Aug 19, 2023
How to document properties parameters? Open

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

numpy/numpydoc#486 · 1 comment · Opened Aug 8, 2023
Add information about the file causing the error Open

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

numpy/numpydoc#482 · 1 reaction · Opened Aug 2, 2023
How to exclude an API member from being processed by numpydoc Open

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

numpy/numpydoc#479 · Opened Jul 24, 2023
Warnings in docstring for constants Open

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

numpy/numpydoc#478 · Opened Jul 19, 2023
Support in third-party tools/lib and how to evolve the spec Open

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

numpy/numpydoc#463 · 5 comments · 2 reactions · Opened Jun 27, 2023
Shorter section underlines trigger ambiguous validation Open

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

numpy/numpydoc#460 · Opened Jun 7, 2023
How to specify numpydoc_validation_checks from CLI Open

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

numpy/numpydoc#459 · 4 comments · 1 reaction · Opened Jun 7, 2023
Validating Enum doc-strings? Open

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

numpy/numpydoc#458 · 1 comment · Opened May 18, 2023
Exception/crash when validating doc-string with `\`-line-break in summary Open

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

numpy/numpydoc#457 · 1 comment · Opened May 18, 2023

numpy/numpydoc

Get new issues in your inbox