Skip to content

Use numpydoc to render the API reference - #3059

Open
vlad-perevezentsev wants to merge 5 commits into
masterfrom
use_numpydocs_in_docs_build
Open

Use numpydoc to render the API reference#3059
vlad-perevezentsev wants to merge 5 commits into
masterfrom
use_numpydocs_in_docs_build

Conversation

@vlad-perevezentsev

Copy link
Copy Markdown
Contributor

This PR switches the documentation build from sphinx.ext.napoleon to numpydoc to render the API reference.
numpydoc renders the Parameters and Returns sections as definition lists out of the box, which lets us remove:

  • the custom doc/_static/dpnp-custom.js that reformatted parameter
    descriptions, together with the CSS rules that only supported it;
  • the napoleon monkeypatch for namedtuple Returns (numpydoc handles it
    natively).

A small hook keeps the dpnp-specific Limitations section and a some docstrings are adjusted for numpydoc's stricter parser.

  • Have you provided a meaningful PR description?
  • Have you added a test, reproducer or referred to an issue with a reproducer?
  • Have you tested your changes locally for CPU and GPU devices?
  • Have you made sure that new changes do not introduce compiler warnings?
  • Have you checked performance impact of proposed changes?
  • Have you added documentation for your changes, if necessary?
  • Have you added your changes to the changelog?

@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

View rendered docs @ https://intelpython.github.io/dpnp/pull/3059/index.html

@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Array API standard conformance tests for dpnp=0.21.0dev7=py314ha0e2e8e_18 ran successfully.
Passed: 1375
Failed: 0
Skipped: 7

@coveralls

Copy link
Copy Markdown
Collaborator

Coverage Status

coverage: 78.489% (-0.003%) from 78.492% — use_numpydocs_in_docs_build into master

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants