codex_rust_crate docstring omits live macro parameters
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 86/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Quiet
- Tech stack
- rust
- Domain
- build-system, documentation
Research direction
Open defs.bzl and inspect the codex_rust_crate macro signature and its Args section, then compare them with the usages in codex-rs/bwrap/BUILD.bazel and the WebRTC-related BUILD files. Done means the docstring documents live parameters such as build_script_enabled and rustc_flags_extra, along with any other supported parameters omitted from the Args section.
Written by the indexing model from the issue text.
Description
What happened?
The codex_rust_crate macro signature in defs.bzl includes parameters that are not documented in the macro docstring's Args section.
Examples:
build_script_enabledrustc_flags_extra
Both parameters are live: build_script_enabled is used to gate build script wiring, and rustc_flags_extra is passed into generated Bazel targets. BUILD files also use these parameters, for example codex-rs/bwrap/BUILD.bazel and several WebRTC-related crates.
Expected behavior
The codex_rust_crate docstring should describe all supported macro parameters, especially parameters already used by first-party BUILD files, so future Bazel changes have accurate local API documentation.
Additional context
I searched open issues and PRs for terms including codex_rust_crate, build_script_enabled, rustc_flags_extra, and docstring, and did not find an existing open item that appears to cover these missing Args entries.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.5k
- Avg merge
- 1m
- Merged PRs (30d)
- 1k
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from openai/codex
-
CLI enhancement model-behavior
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
enhancement remote
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
bug CLI windows-os
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
macOS sandbox blocks hw.optional.arm64 sysctl, causing Flutter to misdetect Apple Silicon as x64 Openbug CLI sandbox
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
bug CLI TUI
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Eynzof/Hermes-CN-Desktop#610 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
gitbutlerapp/gitbutler#15998 · 1 comment ·
-
bug triage:deciding
Difficulty 1/5 Under an hour Newbie friendliness 88/100
open-telemetry/otel-arrow#4132 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100