Skip to content

Add citations/footnotes using remark-gfm - #171

Open
DylanB5402 wants to merge 1 commit into
frcsoftware:mainfrom
DylanB5402:1b-citations
Open

Add citations/footnotes using remark-gfm#171
DylanB5402 wants to merge 1 commit into
frcsoftware:mainfrom
DylanB5402:1b-citations

Conversation

@DylanB5402

@DylanB5402 DylanB5402 commented Aug 2, 2026

Copy link
Copy Markdown
Member

Description

Put together citations/footnote to refer to wpilib or vendordep docs using remark-gfm. Pretty sure this is failing CI right now, wanted to get thoughts on whether we actually like doing citations like this before moving forward with cleaning it up and adding them to the rest of 1b.

See the bottom of this page to see what the footnotes actually look like on a page:

https://pr-171.frcsoftware.pages.dev/learning-course/stage1/stage1b/commands-and-mechanisms/

For #169

@DylanB5402
DylanB5402 requested a review from a team as a code owner August 2, 2026 20:20
@github-actions github-actions Bot added Curriculum material Curriculum materials, lessons for students, etc stage1 infra Any infrastructure for building the website or syncing files labels Aug 2, 2026
@github-actions

github-actions Bot commented Aug 2, 2026

Copy link
Copy Markdown

🌐 Preview URL: https://pr-171.frcsoftware.pages.dev

@zachwaffle4 zachwaffle4 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Starlight natively supports GFM footnotes, the remark plugin is unnecessary.

@Daniel1464

Copy link
Copy Markdown
Contributor

I dig the idea of having footnotes, although I think that they need to be more visually striking. I also think that the footnote section needs different formatting (currently, it seemingly inserts an invisible header)

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

Labels

Curriculum material Curriculum materials, lessons for students, etc infra Any infrastructure for building the website or syncing files stage1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants