Right now, our docstrings reference tests from modules test_<something>_api.py. See for example:

However, we now have a dedicated examples/ directory containing example files (which are also tested on CI):

https://github.com/NVIDIA/cccl/tree/main/python/cuda_cccl/tests/parallel/examples/transform

We should:

• Move tests from out of test_<something>_api.py files, either into the corresponding test_<something>.py file, or to the corresponding example file (depending on whether they are currently referenced in docstrings)
• Change existing docstrings to exclusively reference examples