From 69931fb5f84e2894fee08e91487d29592e21edc8 Mon Sep 17 00:00:00 2001 From: Zach Harel Date: Thu, 30 Jul 2026 17:03:02 -0400 Subject: [PATCH 1/2] enhance stage overview with repository cloning instructions and file tree visualization --- .../stage1/stage1a/stage-overview.mdx | 46 +++++++++++-------- 1 file changed, 28 insertions(+), 18 deletions(-) diff --git a/src/content/docs/learning-course/stage1/stage1a/stage-overview.mdx b/src/content/docs/learning-course/stage1/stage1a/stage-overview.mdx index 80c5a487..05a6c3cd 100644 --- a/src/content/docs/learning-course/stage1/stage1a/stage-overview.mdx +++ b/src/content/docs/learning-course/stage1/stage1a/stage-overview.mdx @@ -5,33 +5,43 @@ prev: ../stage-overview next: false --- +import { FileTree } from '@astrojs/starlight/components'; import YouTube from '../../../../../components/YouTube.astro'; +Welcome to Stage 1A! +Before we can start programming, we have to fork and clone the relevant repository: + +- If your team primarily uses REV electronics (such as Spark MAX motor controllers), clone [the REV template](https://github.com/frcsoftware/Stage1-Template-REV). +- If your team primarily uses CTRE electronics (such as Kraken motors), clone [the CTRE template](https://github.com/frcsoftware/Stage1-Template-CTRE). + + + Now, before we get into the depths of the robot code, it's useful to look at a high-level overview of the contents of a typical WPILib project. As your code gets more advanced, you'll see more folders and files appear, but they're all controlled by the same basic components. -Below, you can see the sample file structure you'll be starting off with as a template for Stage 1A. -If your robot has REV electronics, then the template folder's name will be `rev/` instead of `ctre/` ### Stage 1A Template Structure -{/* rli:ignore */} - -```text -ctre/ -├── src/main/ -| ├── java/first/ -| | ├── robot/ -| | | ├── opmode/ -| | | | ├── MyAuto.java -| | | | ├── MyTeleop.Java -| | | ├── simulation/ -| | | | ├── DrivetrainSim.Java -| | | | ├── SingleFlywheelSim.java -| | | ├── Robot.java -| | ├── Main.java -``` +{/* prettier-ignore */} + +- src + - main + - java + - first + - robot + - opmode + - MyAuto.java + - MyTeleop.java + - simulation + - DrivetrainSim.java + - SingleFlywheelSim.java + - Robot.java + - Main.java + You'll notice that we're skipping a lot of files here, because you don't have to edit those. What's great about using a framework like WPILib is that it automatically generates these files when you create a new project, so you can get started coding quicker. From 2e5b7d3295f858f66ccc1617b39f199dffabb700 Mon Sep 17 00:00:00 2001 From: samfreund Date: Fri, 31 Jul 2026 13:16:42 -0700 Subject: [PATCH 2/2] fix link Signed-off-by: samfreund --- .../docs/learning-course/stage1/stage1a/stage-overview.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/learning-course/stage1/stage1a/stage-overview.mdx b/src/content/docs/learning-course/stage1/stage1a/stage-overview.mdx index 05a6c3cd..cda1fd6e 100644 --- a/src/content/docs/learning-course/stage1/stage1a/stage-overview.mdx +++ b/src/content/docs/learning-course/stage1/stage1a/stage-overview.mdx @@ -16,7 +16,7 @@ Before we can start programming, we have to fork and clone the relevant reposito Now, before we get into the depths of the robot code, it's useful to look at a high-level overview of the contents of a