rust-lang / rust-lang/docs.rs

Enable footnotes for README.md files

Open
#1,743 8 comments 0 reactions 1 assignee View on GitHub

@BGR360 is already working on this.

Since Dec 1, 2022.

A-frontend C-enhancement E-medium
Dominant language
Rust
Stars
1.2k
Forks
232
Avg merge
11h 35m
Merged PRs (30d)
60

Description

There's an actual missing feature still, looking at this diff — footnotes. Do you know if these are actually used in Markdown files parsed by docs.rs? They're not supported by GitHub's own README.md renderer, for what it's worth.

Footnotes are now a part of github-favored markdown[^1], is it now possible to add this feature to the docs?
[^1]:https://github.blog/changelog/2021-09-30-footnotes-now-supported-in-markdown-fields/

This mostly involves enabling in Comrak, where they're already supported.

Originally posted by @zStruCat in https://github.com/rust-lang/docs.rs/issues/117#issuecomment-1147559768

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.