NVIDIA / NVIDIA/cudf

[DOC] Improve Sphinx C++ documentation

Open
#14,747 0 comments 0 reactions 0 assignees View on GitHub
doc libcudf
Dominant language
C++
Stars
9.8k
Forks
1.1k
Avg merge
3d 6m
Merged PRs (30d)
278

Description

## Report needed documentation
As of #13846 we will start publishing the C++ documentation as part of the Sphinx doc build as well as via doxygen. The long-term plan is to unify these two and remove the latter, but before we do so we should make sure that we're happy with the Sphinx output replacing the doxygen. This issue is for tracking improvements that we want to see to the Sphinx docs.

Improvements:
- [ ] Starting list

Once we're happy, the final migration from doxygen will involve the following tasks that cannot be done until the end:
- [ ] Update inline tables in doxygen to a style supported by Sphinx's text builder (see https://github.com/rapidsai/cudf/pull/13846/commits/b2dae66314829ed6c75d10a8dddaea47321dc68c)
- [ ] Update anchors in developer documentation so that cross-linking works via Myst (see https://github.com/rapidsai/cudf/pull/13846/commits/b2dae66314829ed6c75d10a8dddaea47321dc68c)
- [ ] Add developer documentation pages to Sphinx docs (see https://github.com/rapidsai/cudf/pull/13846/commits/b2dae66314829ed6c75d10a8dddaea47321dc68c)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.