Skip to content

Added a Stage1a vocabulary "prestage" page - #156

Open
Adrianamm wants to merge 4 commits into
frcsoftware:mainfrom
Adrianamm:pre1a
Open

Added a Stage1a vocabulary "prestage" page#156
Adrianamm wants to merge 4 commits into
frcsoftware:mainfrom
Adrianamm:pre1a

Conversation

@Adrianamm

Copy link
Copy Markdown
Member

Description

What changed? Why? (the code + comments should speak for itself on the "how")
I added a vocabulary "prestage" page for 1a. This includes basic vocabulary for hardware/electrical terms that aren't explained in the main part of 1a but are important to know when programming the robot. This was added in after feedback was given in the discord. The page is in between the introduction and the "kitbot drive train" page, so it can be easily skipped.
This PR also fixes the Oxford commas in 1b

Merge checklist:

@github-actions github-actions Bot added Curriculum material Curriculum materials, lessons for students, etc stage1 stage0 labels Jul 31, 2026
@github-actions

Copy link
Copy Markdown

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

@samfreund

Copy link
Copy Markdown
Member

This feels like it should be in the glossary?

Comment thread src/content/docs/learning-course/stage1/stage1a/1a-vocabulary.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/1a-vocabulary.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/1a-vocabulary.mdx Outdated
Typically using yellow and green cables, it is used to communicate with motor controllers.
For stage 1a, CAN is used to communicate with motor controllers.
A **CAN Bus** describes the type of connection.
A CAN bus starts at the SystemCore, connects all the motor controllers, and typically ends at the [Power Distribution Hub](https://docs.revrobotics.com/ion-control/pdh/overview).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

A PDH is mentioned, but not even briefly defined. While there is a link to REV docs, it would be a lot nicer to have it defined on this page, so the learner wouldn’t be required to open a separate tab just to learn about a PDH, especially since a PDH can be easily defined.

Comment thread src/content/docs/learning-course/stage1/stage1a/1a-vocabulary.mdx Outdated
Comment thread src/content/docs/learning-course/stage1/stage1a/1a-vocabulary.mdx Outdated

@f4wke5 f4wke5 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

SystemCore is Systemcore and SparkMax is SPARK MAX

@samfreund

Copy link
Copy Markdown
Member

SystemCore is Systemcore and SparkMax is SPARK MAX

We're using SystemCore over SystemCore, that's an intentional choice 😃

@samfreund

Copy link
Copy Markdown
Member

I still think a lot of this is duplicative of what exists in the glossary, we should perhaps re-evaluate the utility/intent of this page.

Adrianamm and others added 3 commits July 31, 2026 16:13
Co-authored-by: Spaceman 11 <135277197+Spaceman113138@users.noreply.github.com>

@f4wke5 f4wke5 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good

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 stage0 stage1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants