IntelPython / dpnp / 36188087365

78%

push

github

Use `numpydoc` to render the API reference (#3059)

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.

1546 of 2898 branches covered (53.35%)

Branch coverage included in aggregate %.

26655 of 33035 relevant lines covered (80.69%)

8622.23 hits per line