Skip to content

don't emit rustdoc::broken_intra_doc_links for stuff like [!NOTE] #144921

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

lolbinarycat
Copy link
Contributor

@lolbinarycat lolbinarycat commented Aug 4, 2025

fixes #141866

@rustbot
Copy link
Collaborator

rustbot commented Aug 4, 2025

r? @notriddle

rustbot has assigned @notriddle.
They will have a look at your PR within the next two weeks and either review your PR or reassign to another reviewer.

Use r? to explicitly pick a reviewer

@rustbot rustbot added S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-libs Relevant to the library team, which will review and decide on the PR/issue. T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue. labels Aug 4, 2025
@rust-log-analyzer

This comment has been minimized.

@lolbinarycat lolbinarycat force-pushed the rustdoc-intra-doc-gfm-141866 branch from 42afec6 to bfea0ee Compare August 4, 2025 19:24
if ignore_urllike && should_ignore_link(path_str) {
return None;
}
// ignore github flavored markdown special blockquotes,
// such as [!NOTE] and [!IMPORTANT]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you elaborate the comment slightly noting that it's ~common for people to include_str the README.md of their GitHub repo?

I think we want to highlight that cuz rustdoc doesn't use GitHub-flavored Markdown and doesn't support GitHub-style admonitions.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah, good point, will elaborate.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

alright, I expanded the documentation and also made sure that [!] is still parsed as a link to the never type.

@rust-log-analyzer

This comment has been minimized.

@lolbinarycat lolbinarycat force-pushed the rustdoc-intra-doc-gfm-141866 branch from bfea0ee to a09b688 Compare August 4, 2025 20:37
@lolbinarycat lolbinarycat force-pushed the rustdoc-intra-doc-gfm-141866 branch from a09b688 to fa095a8 Compare August 4, 2025 20:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-libs Relevant to the library team, which will review and decide on the PR/issue. T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Rustdoc reports broken-intra-doc-links for Github markdown [!IMPORTANT]-type blockquotes
5 participants