Skip to content

docs(conversions): correct stale converter test targets, defaults and revision - #183

Open
janickm wants to merge 1 commit into
NVIDIA:mainfrom
janickm:dev/janickm/fix-stale-converter-docs
Open

docs(conversions): correct stale converter test targets, defaults and revision#183
janickm wants to merge 1 commit into
NVIDIA:mainfrom
janickm:dev/janickm/fix-stale-converter-docs

Conversation

@janickm

@janickm janickm commented Sep 10, 2026

Copy link
Copy Markdown
Collaborator

Description

Four independent staleness fixes found while cross-checking the converter docs
against the code for the ncore skill in #181. Docs only, no code change.

  1. Test targets that do not exist. pytest_test suffixes the Python
    version (bazel/pytest/defs.bzl:30), so :pytest_converter is not a real
    label and the documented command errors out with
    no such target ... did you mean pylib_utils?. Fixed in
    argoverse2/README.md, docs/conversions/argoverse2/argoverse2.rst and
    nuscenes/README.md. (tools/data_converter/README.md already had the
    suffixed form.)

  2. Waymo --profile default. waymo.rst documented default, but both
    waymo/converter.py:1045 and waymo/README.md:43 say separate-sensors.
    All six converters default to separate-sensors.

  3. PAI --revision default. pai/README.md:157 said ncore;
    DEFAULT_REVISION in pai_remote/config.py:28 is main, which
    pai.rst:269 already stated correctly.

Testing

bazel run //:format.check   # clean

Verified each corrected target resolves under bazel query, and each corrected
default against the source.

Type of Change

  • Documentation update

Checklist

  • I have read the Contributing Guidelines
  • My commits follow Conventional Commits format
  • My commits are GPG-signed
  • I have added tests that prove my fix is effective or my feature works — n/a, documentation only
  • New and existing tests pass locally (bazel test //...)
  • Code is formatted (bazel run //:format)
  • I have updated documentation as needed
  • My changes include SPDX license headers on all new files

… revision

Four independent staleness fixes found while cross-checking the docs
against the code:

- Test targets: the pytest_test macro suffixes the Python version, so
  :pytest_converter is not a real label. bazel test on the documented names
  errors out. Use :pytest_converter_3_11 (argoverse2, nuscenes).
- Waymo --profile: the .rst documented a default of 'default' while both the
  code and the converter's own README say 'separate-sensors'. All six
  converters default to separate-sensors.
- PAI --revision: the README said the default is 'ncore'; DEFAULT_REVISION
  in pai_remote/config.py is 'main', which the .rst already stated.
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.

1 participant