validate and fix internal links

astro.config.mjs

@@ -1,5 +1,6 @@
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
+import starlightLinksValidator from 'starlight-links-validator';
 import remarkGlossary from './src/plugins/remark-glossary';
 import remarkCenter from './src/plugins/remark-center';
 import remarkFigure from './src/plugins/remark-figure';
@@ -69,6 +70,7 @@ export default defineConfig({
             tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 3 },
             // Sidebar configuration is now managed in src/config/sidebarConfig.ts
             // This allows different sidebars per top-level navigation section
+            plugins: [starlightLinksValidator()],
         }),
     ],
 });

package.json

@@ -50,6 +50,7 @@
         "remark-lint-no-dead-urls": "^2.0.1",
         "remark-mdx": "^3.1.1",
         "remark-preset-lint-recommended": "^7.0.1",
+        "starlight-links-validator": "^0.20.0",
         "tsx": "^4.22.4",
         "typescript": "^6.0.3",
         "typescript-eslint": "^8.61.1",

src/content/docs/contribution/index.mdx

@@ -14,6 +14,6 @@ The current focus is on getting stages 0, 1, and 2 complete and setting up the w
 
 This is a great time to get involved with this project and have an impact.
 
-<LinkButton href="https://discord.gg/uUugPrPZFs">
+<LinkButton href="https://discord.com/invite/uUugPrPZFs">
     Join our development Discord
 </LinkButton>

src/content/docs/learning-course/index.mdx

@@ -12,7 +12,7 @@ The progression of the course moves from learning how to write Java to programmi
 We start individual mechanisms of robots, using the FRC Kitbot, then move to more complex robots.
 
 Software in FRC is always changing! If you want to give feedback or have comments, feel free to do so through our [Github](https://github.com/frcsoftware/frcsoftware.org)
-or [Discord.](discord.gg/uUugPrPZFs)
+or [Discord.](https://discord.com/invite/uUugPrPZFs)
 
 <CourseSection
     title="Course Setup"

src/content/docs/learning-course/stage0/conditionals.mdx

@@ -27,7 +27,7 @@ This section will cover three types of conditionals which are:
     conditional.](https://www.w3schools.com/java/java_switch.asp)
 </Aside>
 
-Like we mentioned earlier in [Java Fundamentals](/intro-to-java/java-fundamentals/), all programming languages have syntax that needs to be followed.
+Like we mentioned earlier in [Java Fundamentals](/learning-course/stage0/java-fundamentals/), all programming languages have syntax that needs to be followed.
 One part of syntax is keywords.
 As a reminder, a keyword is a reserved word that the compiler uses to run the code.
 In Java, we use the following keywords for conditionals: `if`, `else if`, `else`

src/content/docs/learning-course/stage0/stage-overview.mdx

@@ -15,6 +15,6 @@ This will help ensure that you don’t miss any important information.
 
 This stage will cover the following topics
 
-- [Java Fundamentals](\learning-course\intro-to-java\java-fundamentals)
-- [Operators](\learning-course\stage0\operators/)
-- [Conditionals](\learning-course\stage0\conditionals/)
+- [Java Fundamentals](/learning-course/stage0/java-fundamentals/)
+- [Operators](/learning-course/stage0/operators/)
+- [Conditionals](/learning-course/stage0/conditionals/)

src/content/docs/learning-course/stage1/stage-overview.mdx

@@ -20,5 +20,5 @@ Feel free to play around with the robot and control it in sim once you've finish
 
 This stage is composed of the following sub-stages:
 
-- [Stage 1A](../stage-1a/stage-overview)
-- [WIP](#)
+- [Stage 1A](/learning-course/stage1/stage1a/stage-overview/)
+- [Stage 1B](/learning-course/stage1/stage1b/stage-overview/)

src/content/docs/learning-course/stage1/stage1a/stage-overview.mdx

@@ -115,4 +115,4 @@ And that's all you need to know to get started! The rest of Stage 1A will cover
 
 This stage will cover the following topics:
 
-- [WIP](#)
+- [Stage 1A Commands](/learning-course/stage1/stage1b/command-based-overview/)

src/content/docs/test-content-figure.mdx

@@ -165,6 +165,6 @@ YouTube video with default border
 <ContentFigure
 src="./best-practices/img/docsetup3.webp" alt="Document setup" width="70%"
 >
-Learn more about document setup in the [best practices](/best-practices/) section
+Learn more about document setup in the [best practices](/best-practices/overview/) section
 
 </ContentFigure>