Skip to content

[rustdoc] Add new --book-location option to add a link to associated guide and generate it if local#139769

Open
GuillaumeGomez wants to merge 6 commits intorust-lang:mainfrom
GuillaumeGomez:book-location
Open

[rustdoc] Add new --book-location option to add a link to associated guide and generate it if local#139769
GuillaumeGomez wants to merge 6 commits intorust-lang:mainfrom
GuillaumeGomez:book-location

Conversation

@GuillaumeGomez
Copy link
Copy Markdown
Member

This option adds the possibility to provide a path or a URL to the associated guide of this crate in the crate-level doc page. If the provided argument is a path, then the guide is generated using the mdbook crate.

It looks like this:

Screenshot From 2025-04-14 00-36-23

You can give it a try here.

It'll need an FCP before getting merged.

Also I need to add tests when the argument is a path but I'll wait for the feature form to be final before doing it to prevent doing it more than once. 😄

cc @notriddle
r? @camelid

Loading
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-run-make Area: port run-make Makefiles to rmake.rs A-tidy Area: The tidy tool S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-bootstrap Relevant to the bootstrap subteam: Rust's build system (x.py and src/bootstrap) T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue. T-rustdoc-frontend Relevant to the rustdoc-frontend team, which will review and decide on the web UI/UX output.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

10 participants