Skip to content

Fix broken/stale intra-doc links and export ReplaceError - #126

Merged
asmello merged 1 commit into
mainfrom
fix/docs-cleanup
Jul 26, 2026
Merged

Fix broken/stale intra-doc links and export ReplaceError#126
asmello merged 1 commit into
mainfrom
fix/docs-cleanup

Conversation

@asmello

@asmello asmello commented Jul 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Fixed a broken intra-doc link typo (crate::asign -> crate::assign) and an RFC 6091 -> RFC 6901 typo
  • Fixed a doc comment on Pointer::len that used // instead of /// and was silently dropped from rendered docs
  • Updated stale docs.rs/toml/0.8/... links to 0.9 (matching the toml dependency bump)
  • Exported ReplaceError (returned by PointerBuf::replace) from the crate root — it was pub but unreachable since mod pointer is private, so callers had no way to name the error type
  • Fixed assorted unresolved/redundant intra-doc links in resolve.rs and diagnostic.rs

Test plan

  • cargo doc --all-features — 0 warnings (was 8)
  • cargo test --all-features — all tests pass
  • cargo clippy --all-features --all-targets — clean

- crate::asign typo -> crate::assign in the lib.rs doc-link table
- RFC 6091 -> RFC 6901 typo, and a doc comment that used `//`
  instead of `///` and was silently dropped from rendered docs
- toml docs.rs links pointed at 0.8, dependency is now 0.9
- ReplaceError (returned by PointerBuf::replace) was pub but never
  re-exported from the crate root, since `mod pointer` is private -
  callers had no way to name the type. Added it to the top-level
  `pub use`.
- assorted unresolved/redundant intra-doc links in resolve.rs and
  diagnostic.rs (Index, Subject, PointerBuf::parse, ParseError)

Verified with cargo doc --all-features (0 warnings, was 8),
cargo test --all-features, and cargo clippy --all-features --all-targets.
@asmello
asmello merged commit a5a2a1b into main Jul 26, 2026
21 checks passed
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