Skip to content

Fix malformed :obj: cross-reference roles in docstrings - #3065

Open
antonwolfy wants to merge 1 commit into
masterfrom
fix-obj-role-typos
Open

Fix malformed :obj: cross-reference roles in docstrings#3065
antonwolfy wants to merge 1 commit into
masterfrom
fix-obj-role-typos

Conversation

@antonwolfy

@antonwolfy antonwolfy commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Two See Also entries used obj: instead of :obj: (missing the leading colon), so Sphinx did not recognize the cross-reference role and rendered it as literal obj: text in the API docs:

  • dpnp.argsort — the dpnp.take_along_axis entry rendered as "…from obj: dpnp.argsort…"
  • dpnp.histogram — the dpnp.histogram_bin_edges entry rendered as "…by the obj:dpnp.histogram function"

Adding the missing colon makes both render as proper cross-reference links. This is a docstring-only change with no functional impact.

  • 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?

The See Also entries for dpnp.argsort and dpnp.histogram_bin_edges used
`obj:` instead of `:obj:` (missing the leading colon), so the role was
not recognized and rendered as literal "obj:" text in the API docs.
Add the missing colon so the cross-references render as proper links.
@antonwolfy antonwolfy self-assigned this Sep 9, 2026
@antonwolfy antonwolfy added this to the 0.21.0 release milestone Sep 9, 2026
@antonwolfy
antonwolfy marked this pull request as ready for review September 9, 2026 16:42
@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

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

@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Array API standard conformance tests for dpnp=0.21.0dev8=py314ha0e2e8e_6 ran successfully.
Passed: 1376
Failed: 0
Skipped: 6

@coveralls

Copy link
Copy Markdown
Collaborator

Coverage Status

coverage: 78.495% (+0.003%) from 78.492% — fix-obj-role-typos 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