Skip to content

Add hardware intro and resources overview pages#104

Open
reniejoshi wants to merge 17 commits into
frcsoftware:mainfrom
reniejoshi:hardware-intro
Open

Add hardware intro and resources overview pages#104
reniejoshi wants to merge 17 commits into
frcsoftware:mainfrom
reniejoshi:hardware-intro

Conversation

@reniejoshi

@reniejoshi reniejoshi commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Description

Add hardware intro page that briefly covers motors, encoders, and gyroscopes for programmers, including code snippets showing common use cases. This serves to introduce programmers to basic hardware components that they will encounter in writing FRC robot code. Closes #23.

Add overview page for resources navigation with styles and visual components similar to FRCDesign.org.

Meta

Merge checklist:

@github-actions

Copy link
Copy Markdown

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

@reniejoshi reniejoshi changed the title Add hardware intro page Add hardware intro and resources overview pages Jul 20, 2026
Comment thread examples/resources/src/main/java/sources/HardwareIntro.java
@Spaceman113138

Copy link
Copy Markdown
Contributor

I would make a distinction between absolute and relative encoders.

@roboteer5291 roboteer5291 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I like what you've written, but I think some reconsideration on the purpose of this section would be good. It feels like a weird mix between resources, best practices, and teaching. I think we'd be best served to keep this section as much of resources as possible, since best practices and teaching already have a home within the learning course (and best practices may get their own section, tbd).

I also think that it'd be wise to include the distinction of encoder types from a software functionality perspective as mentioned, and to also include mention of beam breaks/retroreflective sensors and distance sensors (noting that those are most commonly used as a beam break-esque sensor).

Comment thread src/content/docs/resources/hardware-intro.mdx
Comment thread src/content/docs/resources/hardware-intro.mdx Outdated
Comment thread src/content/docs/resources/hardware-intro.mdx Outdated
@github-actions github-actions Bot added Curriculum material Curriculum materials, lessons for students, etc examples labels Jul 22, 2026
@samfreund
samfreund requested a review from a team as a code owner July 22, 2026 18:09
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 examples

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Hardware Intro

5 participants