Skip to content

docs: refresh QDP Python API docstrings#1335

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

docs: refresh QDP Python API docstrings#1335
viiccwen wants to merge 1 commit into
apache:mainfrom
viiccwen:docs/qdp-refresh-api-docstrings

Conversation

@viiccwen
Copy link
Copy Markdown
Contributor

@viiccwen viiccwen commented May 25, 2026

Related Issues

Closes #1337

Changes

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

Why

Several existing QDP Python API docstrings were too short or no longer described the current public behavior clearly enough. This made the engine, tensor wrapper, data loader builder, benchmark helpers, and Triton AMD backend surface harder to understand from the Python API itself.

Refreshing these docstrings improves the user-facing API documentation while keeping the scope limited to documentation-only changes.

How

  • refresh short or outdated docstrings for public QDP Python APIs
  • clarify QDP engine, tensor wrapper, data loader builder, benchmark result/config, and Triton AMD backend behavior
  • keep the change documentation-only with no runtime behavior changes
  • preserve the existing reStructuredText-friendly docstring style instead of introducing broad style churn

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:45
@viiccwen viiccwen marked this pull request as draft May 25, 2026 15:46
@viiccwen viiccwen force-pushed the docs/qdp-refresh-api-docstrings branch from f41b21c to d93a693 Compare May 25, 2026 15:56
@viiccwen viiccwen marked this pull request as ready for review May 25, 2026 16:03
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] Refresh QDP Python API docstrings

1 participant