View rendered docs @ https://intelpython.github.io/dpctl/pulls/1123/index.html

Coverage: 82.45% (+0.02%) from 82.427% when pulling 49c3a9c on tensor-docs-cleanup into 8f828f2 on master.

Array API standard conformance tests for dpctl=0.14.2=py310h76be34b_41 ran successfully.
Passed: 46
Failed: 788
Skipped: 280

Array API standard conformance tests for dpctl=0.14.2=py310h76be34b_42 ran successfully.
Passed: 46
Failed: 788
Skipped: 280

@oleksandr-pavlyk
Documentation for place doesn't seem to be rendering correctly. It cuts off after the first parameter.
validate_usm_type summary renders as "[FIXME]: <class ‘builtin_function_or_method’> has a docstring with no summary"

@oleksandr-pavlyk Found few left over issues: reshape, from_dlpack still have the -> in the summary.

@oleksandr-pavlyk Found few left over issues: reshape, from_dlpack still have the -> in the summary.

It is a Sphinx issue IMO. The header of the detail section looks so much better with the -> and it even auto links to the usm_ndarray doc. The summary is butchered up.

@oleksandr-pavlyk Can you please check the following function in our generate_rst.py:

Maybe we need to fix the logic here and the -> do not need to be removed from the signature in the docstring. Having the arrows generates much better detailed sections, and the butchered summary is in fact our doing.

Array API standard conformance tests for dpctl=0.14.2=py310h76be34b_44 ran successfully.
Passed: 46
Failed: 788
Skipped: 280

Array API standard conformance tests for dpctl=0.14.2=py310h76be34b_45 ran successfully.
Passed: 46
Failed: 788
Skipped: 280

@oleksandr-pavlyk Can you please check the following function in our generate_rst.py:

dpctl/docs/generate_rst.py

Line 378 in 8f828f2

def _get_doc_summary(obj):

Maybe we need to fix the logic here and the -> do not need to be removed from the signature in the docstring. Having the arrows generates much better detailed sections, and the butchered summary is in fact our doing.

I think we should be using Python's typing support in dpctl.tensor functions for IDE to pick up arrows and more details.
It does not belong to the docstrings.

Deleted rendered PR docs from intelpython.github.com/dpctl, latest should be updated shortly. 🤞

Array API standard conformance tests for dpctl=0.14.2=py310h76be34b_45 ran successfully.
Passed: 46
Failed: 788
Skipped: 280