Merge pull request #71 from danbaruka/main

fix: update production URL and resolve all build warnings

Author: Ranchhand87

.gitignore

@@ -106,6 +106,10 @@ dist
 
 # Docusaurus cache and generated files
 .docusaurus
+build/
+website/build/
+contributor-beginner/
+contributor-beginner/build/
 
 # Serverless directories
 .serverless/

website/docs/getting-started.md

@@ -16,18 +16,18 @@ This repository serves as the comprehensive guide for developers and contributor
 **[Complete Intersect Membership Guide →](./intersect-membership-guide.md)**
 
 ### 2. **New to Cardano?**
-Start with our comprehensive ecosystem overview: [**Directive: Kickoff & Orientation**](./Guides/directive-kickoff.md)
+Start with our comprehensive ecosystem overview: [**Directive: Kickoff & Orientation**](./working-group/q1-2025/sessions/01-kickoff-orientation/directive-kickoff.md)
 
 This guide provides a complete map of the Cardano ecosystem, including core repositories, documentation resources, developer tools, and community support channels.
 
 ### 3. **Ready to Build?**
-Dive into our hands-on [**Beginner Guides**](./Guides/Beginner/) to start building immediately:
+Dive into our hands-on [**Beginner Guides**](./how-to-guide/beginner/) to start building immediately:
 - Understanding Cardano addresses
 - Creating transactions
 - Working with native tokens
 
 ### 4. **Want to Contribute?**
-Join our [**Developer Experience Working Group**](./Working-Group/Q1-2025/) - a quarterly initiative focused on onboarding new developers and improving the overall developer experience.
+Join our [**Developer Experience Working Group**](./working-group/q1-2025/) - a quarterly initiative focused on onboarding new developers and improving the overall developer experience.
 
 ## What You'll Find Here
 
@@ -42,21 +42,21 @@ Built by the community, for the community. Join our working groups and help shap
 
 ## Repository Structure
 
-### [Guides](./Guides/)
-- **[Beginner](./Guides/Beginner/)** - Getting started guides for newcomers
-- **[Intermediate](./Guides/Intermediate/)** - Next-level guides for developers with basic knowledge  
-- **[Advanced](./Guides/Advanced/)** - Deep-dive technical guides for experienced developers
+### How-To Guides
+- **[Beginner](./how-to-guide/beginner/)** - Getting started guides for newcomers
+- **[Intermediate](./how-to-guide/intermediate/)** - Next-level guides for developers with basic knowledge  
+- **[Advanced](./how-to-guide/advanced/)** - Deep-dive technical guides for experienced developers
 
-### [Tutorials](./Tutorials/)
-- **[Hands-On](./Tutorials/Hands-On/)** - Interactive coding tutorials and workshops
+### Tutorials
+- **Hands-On** - Interactive coding tutorials and workshops
 
-### [Resources](./Resources/)
-- **[Repositories](./Resources/Repositories/)** - Essential GitHub repositories and their purposes
-- **[Tools](./Resources/Tools/)** - Development tools, APIs, and utilities
-- **[Community](./Resources/Community/)** - Community channels, forums, and support resources
+### Resources
+- **[Repositories](./resources/repositories)** - Essential GitHub repositories and their purposes
+- **[Tools](./resources/tools)** - Development tools, APIs, and utilities
+- **[Community](./resources/community)** - Community channels, forums, and support resources
 
-### [Working Group](./Working-Group/)
-- **[DevEx Working Group](./Working-Group/)** - Developer Experience Working Group materials and session content
+### [Working Group](./working-group/)
+- **[DevEx Working Group](./working-group/)** - Developer Experience Working Group materials and session content
 
 ## Current Focus: Q1 2025
 
@@ -70,7 +70,7 @@ Our Developer Experience Working Group is running a 12-session program designed
 - **Provide live support** through open clinic sessions
 - **Foster contribution** to documentation and open source projects
 
-[**Join the Working Group →**](./Working-Group/Q1-2025/)
+[**Join the Working Group →**](./working-group/q1-2025/)
 
 ## Getting Help
 
@@ -94,7 +94,7 @@ We welcome contributions to improve the developer experience! Whether you want t
 - Share your developer story
 - Lead a workshop or session
 
-See our [**Contributing Guidelines**](../CONTRIBUTING.md) to get started.
+See our [**Contributing Guidelines**](https://github.com/IntersectMBO/developer-experience/blob/main/CONTRIBUTING.md) to get started.
 
 ## Recognition
 
@@ -118,11 +118,11 @@ By the end of Q1 2025, we aim to:
 
 **Step 1**: [Join Intersect - Get Your Voice in Cardano](./intersect-membership-guide.md)
 
-**Step 2**: [Directive: Kickoff & Orientation](./Guides/directive-kickoff.md)
+**Step 2**: [Directive: Kickoff & Orientation](./working-group/q1-2025/sessions/01-kickoff-orientation/directive-kickoff.md)
 
-**Step 3**: [Beginner Guides](./Guides/Beginner/)
+**Step 3**: [Beginner Guides](./how-to-guide/beginner/)
 
-**Step 4**: [Join the Developer Experience Working Group](./Working-Group/)
+**Step 4**: [Join the Developer Experience Working Group](./working-group/)
 
 ---
 

website/docs/how-to-guide/advanced/README.md

@@ -32,7 +32,7 @@ Welcome to the Advanced Guides section! These guides are for experienced develop
 
 Advanced guides assume you have:
 - Extensive experience with Cardano development
-- Completed multiple [Intermediate Guides](../Intermediate/)
+- Completed multiple [Intermediate Guides](../intermediate/)
 - Deep understanding of blockchain fundamentals
 - Production experience with Cardano applications
 - Familiarity with Haskell or other functional programming languages
@@ -50,7 +50,7 @@ At this level, you're ready to:
 
 - **Core Development**: Contribute to [IntersectMBO repositories](https://github.com/IntersectMBO)
 - **Research**: Engage with [IOG Research](https://iohk.io/en/research/library/)
-- **Community Leadership**: Lead [Working Group sessions](../../Working-Group/)
+- **Community Leadership**: Lead [Working Group sessions](../../working-group/)
 - **Mentorship**: Help in Discord and Stack Exchange
 
 ## Resources for Advanced Developers

website/docs/how-to-guide/beginner/README.md

@@ -45,7 +45,7 @@ If you get stuck while following these guides:
 
 ## Contributing
 
-Found an issue or want to improve a guide? See our [Contributing Guidelines](../../../CONTRIBUTING.md) for how to help make these resources better.
+Found an issue or want to improve a guide? See our [Contributing Guidelines](https://github.com/IntersectMBO/developer-experience/blob/main/CONTRIBUTING.md) for how to help make these resources better.
 
 ---
 

website/docs/working-group/q1-2025/README.md

@@ -238,7 +238,7 @@ This theme emphasizes that Q1 2025 is about building the fundamental knowledge,
 ### For New Participants
 1. First become a member at [Intersect](https://www.intersectmbo.org/) and register at [members.intersectmbo.org](https://members.intersectmbo.org/registration). After joining, you'll get access to our Discord community
 2. Introduce yourself in the Developer Experience channel
-3. Review the [Directive: Kickoff & Orientation](../../Guides/directive-kickoff.md) guide
+3. Review the [Directive: Kickoff & Orientation](./sessions/01-kickoff-orientation/directive-kickoff.md) guide
 4. Attend the weekly working group sessions
 5. Follow along with hands-on exercises
 6. Contribute to documentation and community resources

website/docs/working-group/q1-2025/sessions/01-kickoff-orientation/directive-kickoff.md

@@ -173,7 +173,7 @@ _Join working groups through the [Intersect portal](https://intersectmbo.org)_
 - [ ] Complete a tutorial from [developers.cardano.org](https://developers.cardano.org)
 - [ ] After becoming an Intersect member, join relevant Discord channels and introduce yourself
 - [ ] Explore testnet with test ADA from [faucet](https://docs.cardano.org/cardano-testnet/tools/faucet)
-- [ ] Read [CONTRIBUTING.md](../../../CONTRIBUTING.md) guidelines
+- [ ] Read [CONTRIBUTING.md](https://github.com/IntersectMBO/developer-experience/blob/main/CONTRIBUTING.md) guidelines
 - [ ] Make your first contribution (documentation, code, or testing)
 
 ### For dApp Developers

website/docs/working-group/readme.md

@@ -12,13 +12,13 @@ Our focus for Q1 2025 is creating a clear entry path for newcomers, addressing c
 
 ## Current Quarter
 
-### [Q1 2025: Laying the Foundations](./Q1-2025/)
+### [Q1 2025: Laying the Foundations](./q1-2025/)
 Our current quarterly initiative focused on creating a clear entry path for newcomers to the Cardano ecosystem.
 
-- **[Complete Plan](./Q1-2025/)** - Detailed session plans and logistics
-- **[All Sessions](./Q1-2025/sessions/)** - 12 weekly session materials  
-- **[Resources](./Q1-2025/resources/)** - Troubleshooting guides and essential bookmarks
-- **[Media](./Q1-2025/media/)** - Session recordings and explainer videos
+- **[Complete Plan](./q1-2025/)** - Detailed session plans and logistics
+- **All Sessions** - 12 weekly session materials (see individual session folders)
+- **[Resources](./q1-2025/resources/)** - Troubleshooting guides and essential bookmarks
+- **Media** - Session recordings and explainer videos (coming soon)
 
 ## Future Quarters
 
@@ -66,4 +66,4 @@ This working group aims to create resources that the community adopts as the go-
 
 ---
 
-*For detailed session plans and learning objectives, see the [Q1 2025 Plan](./devex-wg-q1-2025-plan.md)*
+*For detailed session plans and learning objectives, see the [Q1 2025 folder](./q1-2025/)*

website/docusaurus.config.ts

@@ -10,7 +10,7 @@ const config: Config = {
   favicon: "img/favicon.ico",
 
   // Set the production url of your site here
-  url: "https://intersectmbo.github.io",
+  url: "https://devex.intersectmbo.org",
   // Set the /<baseUrl>/ pathname under which your site is served
   // For GitHub pages deployment, it is often '/<projectName>/'
   baseUrl: "/developer-experience/",
@@ -21,7 +21,7 @@ const config: Config = {
   projectName: "developer-experience", // Usually your repo name.
 
   onBrokenLinks: "throw",
-  onBrokenMarkdownLinks: "warn",
+  onBrokenMarkdownLinks: "throw",
 
   // Even if you don't use internationalization, you can use this field to set
   // useful metadata like html lang. For example, if your site is Chinese, you
@@ -39,18 +39,7 @@ const config: Config = {
           sidebarPath: "./sidebars.ts",
           // Please change this to your repo.
         },
-        blog: {
-          showReadingTime: true,
-          feedOptions: {
-            type: ["rss", "atom"],
-            xslt: true,
-          },
-          // Please change this to your repo.
-          // Useful options to enforce blogging best practices
-          onInlineTags: "warn",
-          onInlineAuthors: "warn",
-          onUntruncatedBlogPosts: "warn",
-        },
+        blog: false, // Disabled until blog posts are added
         theme: {
           customCss: "./src/css/custom.css",
         },
@@ -94,7 +83,7 @@ const config: Config = {
           items: [
             {
               label: "Documentation",
-              to: "/docs/get-started",
+              to: "/docs/getting-started",
             },
           ],
         },
@@ -114,10 +103,10 @@ const config: Config = {
         {
           title: "More",
           items: [
-            {
-              label: "Blog",
-              to: "/blog",
-            },
+            // {
+            //   label: "Blog",
+            //   to: "/blog",
+            // },
             {
               label: "GitHub",
               href: "https://github.com/IntersectMBO/developer-experience",