NVIDIA / NVIDIA/cuda-python

Figure out how to document anonymous structs/unions

Open
#151 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

cuda.bindings documentation P2
Dominant language
Cython
Stars
3.4k
Forks
329
Avg merge
1d 23h
Merged PRs (30d)
116

Description

Ex: https://nvidia.github.io/cuda-python/module/driver.html#cuda.bindings.driver.CUasyncNotificationInfo

The member info is of type anon_union2, which is undocumented.

Setting this to P2 without a milestone, as people can always refer to the C API reference. But we don't want to lose track of this.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked CUasyncNotificationInfo API documentation and inspect how its info member is currently rendered. Trace the documentation path for the anonymous anon_union2 type; done means the anonymous struct or union and its members are documented rather than omitted.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.