Skip to content

docs: fix broken intra-doc links under -D warnings#87

Merged
iainmcgin merged 1 commit intomainfrom
docs/rustdoc-warning-cleanup
May 2, 2026
Merged

docs: fix broken intra-doc links under -D warnings#87
iainmcgin merged 1 commit intomainfrom
docs/rustdoc-warning-cleanup

Conversation

@iainmcgin
Copy link
Copy Markdown
Collaborator

Unblocks RUSTDOCFLAGS=-D warnings cargo doc --workspace --no-deps on default features (part of the pre-tag verify).

  • buffa-codegen: SENTINEL_MOD and package_to_mod_filename linked to the crate-private validate_file (public_private_link).
  • buffa/src/extension.rs: module doc linked to crate::type_registry, which is #[cfg(any(feature = "json", feature = "text"))] and therefore unresolved on default features (broken_intra_doc_links).

Both replaced with plain code spans. No behavior change.

Separately discovered while testing this: cargo build -p buffa-types --features arbitrary fails to compile (Any.value: Bytes lacks Arbitrary<'_>). Regression from #51; tracked separately.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 29, 2026

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@iainmcgin iainmcgin marked this pull request as ready for review April 29, 2026 23:12
@iainmcgin iainmcgin requested a review from asacamano April 29, 2026 23:12
SENTINEL_MOD and package_to_mod_filename linked to the crate-private
validate_file; extension.rs linked to the type_registry module which is
gated behind cfg(any(json, text)). Both fail RUSTDOCFLAGS=-D warnings
cargo doc on default features. Replaced with plain code spans.
@iainmcgin iainmcgin force-pushed the docs/rustdoc-warning-cleanup branch from 2097257 to 5b9b4c6 Compare May 2, 2026 01:22
@iainmcgin iainmcgin requested review from rpb-ant and removed request for asacamano May 2, 2026 01:25
@iainmcgin iainmcgin merged commit d0c3049 into main May 2, 2026
7 checks passed
@iainmcgin iainmcgin deleted the docs/rustdoc-warning-cleanup branch May 2, 2026 17:37
@github-actions github-actions Bot locked and limited conversation to collaborators May 2, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants