Skip to content

docs: add missing QDP Python API docstrings#1334

Open
viiccwen wants to merge 1 commit into
apache:mainfrom
viiccwen:docs/qdp-missing-docstrings
Open

docs: add missing QDP Python API docstrings#1334
viiccwen wants to merge 1 commit into
apache:mainfrom
viiccwen:docs/qdp-missing-docstrings

Conversation

@viiccwen
Copy link
Copy Markdown
Contributor

@viiccwen viiccwen commented May 25, 2026

Related Issues

Closes #1336

Changes

  • Bug fix
  • New feature
  • Refactoring
  • Documentation
  • Test
  • CI/CD pipeline
  • Other

Why

The QDP Python public API still had several public-facing methods without docstrings, including engine encoding, DLPack/Torch tensor interoperability, benchmark builder methods, and Triton AMD availability/encoding helpers.

Adding these docstrings makes the current API easier to understand and prevents future generated API documentation from exposing undocumented public members.

How

  • add missing docstrings for canonical public QDP Python APIs
  • cover QDP engine encoding, DLPack/Torch tensor interop, benchmark builder methods, and Triton AMD availability/encoding methods
  • keep the change documentation-only with no runtime behavior changes
  • use reStructuredText-friendly Python docstrings consistent with nearby Mahout code

Checklist

  • Added or updated unit tests for all changes
  • Added or updated documentation for all changes

@viiccwen viiccwen marked this pull request as draft May 25, 2026 15:33
@viiccwen viiccwen marked this pull request as ready for review May 25, 2026 15:43
@viiccwen viiccwen marked this pull request as draft May 25, 2026 15:46
@viiccwen viiccwen marked this pull request as ready for review May 25, 2026 15:47
@viiccwen viiccwen marked this pull request as draft May 25, 2026 15:53
@viiccwen viiccwen marked this pull request as ready for review May 25, 2026 16:02
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.

[Docs] Add missing QDP Python API docstrings

1 participant