Skip to content
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

crl: avoid markdown footnotes #284

Merged
merged 1 commit into from
Jul 7, 2024
Merged

Conversation

cpu
Copy link
Member

@cpu cpu commented Jul 6, 2024

Nightly rustdoc flags these as non-standard markdown, and they don't render as nicely as just using a link. See also rustls/rustls#2033, rustls/webpki#268

Fixes build errors on main.

Nightly rustdoc flags these as non-standard markdown, and they don't
render as nicely as just using a link.
@cpu cpu self-assigned this Jul 6, 2024
@cpu
Copy link
Member Author

cpu commented Jul 7, 2024

Since this is docs only I'm going to merge with one positive review. Happy to iterate if there's any additional feedback.

@cpu cpu added this pull request to the merge queue Jul 7, 2024
Merged via the queue into rustls:main with commit 746da00 Jul 7, 2024
13 checks passed
@cpu cpu deleted the cpu-rustdoc-nightly-fix branch July 7, 2024 12:49
@notriddle
Copy link

Just to be clear, you got a warning because you forgot the : on the footnote definition. You could have fixed the warning this way:

-[^1] <https://www.rfc-editor.org/rfc/rfc5280#section-5.3.1>
+[^1]: <https://www.rfc-editor.org/rfc/rfc5280#section-5.3.1>

If you want to use footnotes and have them continue to work, try writing the Markdown you want in a GitHub comment and see if the preview tab looks right.

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.

3 participants