diff --git a/public/examples/6328-2026-robot.webp b/public/examples/6328-2026-robot.webp deleted file mode 100644 index 3cf85254..00000000 Binary files a/public/examples/6328-2026-robot.webp and /dev/null differ diff --git a/public/examples/9496-2026-robot.webp b/public/examples/9496-2026-robot.webp new file mode 100644 index 00000000..b7bee2c4 Binary files /dev/null and b/public/examples/9496-2026-robot.webp differ diff --git a/src/config/sidebarConfig.ts b/src/config/sidebarConfig.ts index fc57128f..3f5a9526 100644 --- a/src/config/sidebarConfig.ts +++ b/src/config/sidebarConfig.ts @@ -298,10 +298,10 @@ export const sidebarSections: Record = { label: 'Resources', items: [ { label: 'Overview', slug: 'resources/overview' }, - { label: 'Glossary', slug: 'resources/glossary' }, { label: 'Documentation', slug: 'resources/docs' }, { label: 'Hardware', slug: 'resources/hardware-intro' }, { label: 'Examples', slug: 'resources/examples' }, + { label: 'Glossary', slug: 'resources/glossary' }, ], }, ], @@ -383,16 +383,16 @@ export const sidebarSections: Record = { slug: 'resources/examples', }, { - label: 'Glossary', - slug: 'resources/glossary', + label: 'Documentation', + slug: 'resources/docs', }, { label: 'Hardware', slug: 'resources/hardware-intro', }, { - label: 'Documentation', - slug: 'resources/docs', + label: 'Glossary', + slug: 'resources/glossary', }, ], }, diff --git a/src/content/docs/resources/examples.mdx b/src/content/docs/resources/examples.mdx index 087a0c9b..c122dd61 100644 --- a/src/content/docs/resources/examples.mdx +++ b/src/content/docs/resources/examples.mdx @@ -6,72 +6,81 @@ description: A programming reference featuring FRC robot code repositories, best export const kitbots = [ { title: '2024 Kitbot', + category: 'Commands v2', image: '/examples/2024-kitbot.webp', imageAlt: '2024 kitbot render', code: 'https://github.com/frcsoftware/Kitbot-Examples/tree/main/2024', + guide: 'https://github.com/frcsoftware/Kitbot-Examples/blob/main/2024/Java/Kitbot%20Java%20Code%20Guide.pdf', }, { title: '2025 Kitbot', + category: 'Commands v2', image: '/examples/2025-kitbot.webp', imageAlt: '2025 kitbot render', code: 'https://github.com/frcsoftware/Kitbot-Examples/tree/main/2025', + guide: 'https://github.com/frcsoftware/Kitbot-Examples/blob/main/2025/Java/KitBot_Java_Software_Guide.pdf', }, { title: '2026 Kitbot', + category: 'Commands v2', image: '/examples/2026-kitbot.webp', imageAlt: '2026 kitbot render', code: 'https://github.com/frcsoftware/Kitbot-Examples/tree/main/2026', + guide: 'https://github.com/frcsoftware/Kitbot-Examples/blob/main/2026/Java/2026-kitbot-java-guide.pdf', + }, -]; +]; +// export const examples = [ - { - title: "6328's 2026 Code", - image: '/examples/6328-2026-robot.webp', - imageAlt: '6328 2026 robot render', - category: 'Advanced Software', - description: - 'IO layer, hub shift tracker, sotm with drum shooter, hood anti-decapitation trench bounds, battery state estimator, and a variety of Gradle plugins', - repo: 'https://github.com/Mechanical-Advantage/RobotCode2026Public', - chiefdelphi: - 'https://www.chiefdelphi.com/t/frc-6328-mechanical-advantage-2026-build-thread/509595', - }, - { - title: "1678's 2026 Code", - image: '/examples/1678-2026-robot.webp', - imageAlt: '1678 2026 robot render', - category: '', - description: - 'Team library, custom targeting system, and customer power analyzer', - repo: 'https://github.com/frc1678/C2026-Public', - chiefdelphi: - 'https://www.chiefdelphi.com/t/1678-citrus-circuits-2026-cad-and-robot-code-release/521535', - }, - { - title: "581's 2026 Code", - image: '/examples/581-2026-robot.webp', - imageAlt: '581 2026 robot render', - category: 'Best Practices', - description: - 'Advanced software practices, automation, and team programming documentation', - repo: 'https://github.com/team581/frc-2026', - chiefdelphi: - 'https://www.chiefdelphi.com/t/581-blazing-bulldogs-2026-cad-and-code-release/521762', - }, +{ +title: "9496's 2026 Code", +category: 'Commands v2', +image: '/examples/9496-2026-robot.webp', +imageAlt: 'Photo of 9496 2026 robot', +description: 'Commands v2 best practices, automated decision making, and modular auto modes', +repo: 'https://github.com/LynkRobotics/RobotCode2026Public', +chiefdelphi: 'https://www.chiefdelphi.com/t/lynk-9496-build-log-2026/511797', +}, +{ +title: "1678's 2026 Code", +category: 'Commands v2', +image: '/examples/1678-2026-robot.webp', +imageAlt: '1678 2026 robot render', +description: +'Team library, custom targeting system, and custom power analyzer', +repo: 'https://github.com/frc1678/C2026-Public', +chiefdelphi: +'https://www.chiefdelphi.com/t/1678-citrus-circuits-2026-cad-and-robot-code-release/521535', +}, +{ +title: "581's 2026 Code", +category: 'Commands v2', +image: '/examples/581-2026-robot.webp', +imageAlt: '581 2026 robot render', +description: +'Advanced software practices, automation, and team programming documentation', +repo: 'https://github.com/team581/frc-2026', +chiefdelphi: +'https://www.chiefdelphi.com/t/581-blazing-bulldogs-2026-cad-and-code-release/521762', +}, ];

- Don't be afraid to take inspiration from robot code that already solved hard - programming problems. This library collects code analysis and repositories - so teams can study real examples, compare approaches, and build better code - faster. + Examples are a great learning resource. + They can be used to learn how other teams approached different problems, or can be used as a reference. + Looking over code and trying to understand how it works is also a great way to learn FRC programming. + This page has links to past years' Kitbot, and code from other FRC team. + + If you are interested in adding robot code, check out the [Methods Of Contributing page.](/contribution/methodsofcontributing/) +

Intro level

-

Kitbot Examples

-

These kitbot examples show starter code for teams using past season's kitbots.

+

Kitbot Examples

+

Kitbots are a starter robot which makes their code a great resource for beginners.

@@ -83,10 +92,12 @@ export const examples = [
)}
+

{example.category}

{example.title}

Code + Java Guide
))} @@ -97,7 +108,7 @@ export const examples = [

Team codebases

Advanced Examples

-

These examples go beyond the basics and highlight things top teams have done well in their code.

+

The code for these robots go beyond the basics as they have more complex mechanisms.

@@ -114,8 +125,10 @@ export const examples = [

{example.description}

- Repo - Chief Delphi + Repository + {example.chiefdelphi && ( + Write Up + )}
))} diff --git a/src/content/docs/resources/overview.mdx b/src/content/docs/resources/overview.mdx index d0c24069..81ce9cb6 100644 --- a/src/content/docs/resources/overview.mdx +++ b/src/content/docs/resources/overview.mdx @@ -12,6 +12,15 @@ import CourseSection from '@components/CourseSection.astro'; Many other resources exist out there for FRC programming. The Resource section includes different resources that can be helpful for learning more programming or for the build season! + +

+ Examples are a great learning resource. They can be used as a reference + for how to program a mechanism, and you can learn how other teams solved + problems. This page has links to past years’ Kitbot, and code from other + FRC teams +

+ +

A lot of documentation from _FIRST_ Vendors, software libraries, logging diff --git a/src/styles/global.css b/src/styles/global.css index 39994597..b6dca251 100644 --- a/src/styles/global.css +++ b/src/styles/global.css @@ -829,8 +829,9 @@ html.sidebar-collapsed .sidebar-collapsed-toggle-wrapper { .featured-links { display: flex; + flex-direction: column; justify-content: center; - gap: 1rem; + gap: 0.6rem; margin: 0 auto 1rem auto; width: 100%; padding: 0 1rem; @@ -838,7 +839,6 @@ html.sidebar-collapsed .sidebar-collapsed-toggle-wrapper { } .featured-links a { - flex: 1; display: flex; align-items: center; justify-content: center;