Skip to content

Occurrences of a libstd or libextra item in the tutorial and manual should link to the docs for it #6758

Closed
@lkuper

Description

@lkuper

Masklinn recently suggested on rust-dev that it would be nice to have cross-linking within the generated HTML docs. E.g., an occurrence of "println" in the tutorial would be a link to here (if I understand the suggestion correctly). We could do this cross-linking for all top-level items: types, traits, functions, impls, etc.

I wouldn't expect this to happen for code blocks, just for inline code. Ideally, there would also be a way to turn it off -- both in the sense that we might want to be able to tell rustdoc not to do cross-linking on a particular run (to make the docs build faster), and in the sense that we might want to be able to specify that particular occurrences should never be cross-linked (because after a point it might hinder readability).

Presumably we'd also eventually want this cross-linking within the documentation itself, too, as well as in the tutorial and manual.

Metadata

Metadata

Assignees

No one assigned

    Labels

    E-hardCall for participation: Hard difficulty. Experience needed to fix: A lot.T-rustdocRelevant to the rustdoc team, which will review and decide on the PR/issue.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions