Refactor documentation structure: update blog post guide references, renumber sections, and remove outdated files

Signed-off-by: Daniel Ntege <danientege785@gmail.com>

Author: danielmarv

README.md

@@ -92,6 +92,6 @@ Netlify builds run `pnpm install` and `pnpm run build` (see `netlify.toml`).
 ## Documentation
 
 - **[Docs Hub](docs/README.md)** - First stop for contributors (repository architecture, content workflows, quality checks)
-- **[Adding Blog Posts](docs/07-adding-blog-post.md)** - Post-specific workflow for `content/posts/`, front matter, and `/posts/...` linking conventions
+- **[Adding Blog Posts](docs/04-adding-blog-post.md)** - Post-specific workflow for `content/posts/`, front matter, and `/posts/...` linking conventions
 - **[Adding New Pages Guide](ADDING_PAGES.md)** - Legacy page-creation guide with EN/DE examples and image/layout notes
 

docs/02-content-folder.md

@@ -72,7 +72,7 @@ content/posts/
 
 **Usage**: Blog articles, release notes, announcements
 
-For a complete, post-specific workflow (including front matter and link conventions), see [07 - Adding Blog Posts](./07-adding-blog-post.md).
+For a complete, post-specific workflow (including front matter and link conventions), see [04 - Adding Blog Posts](./04-adding-blog-post.md).
 
 ### Pattern 3: Version Updates CHANGELOG
 

docs/03-adding-pages.md

@@ -9,11 +9,11 @@ This comprehensive guide walks you through the entire process of adding a new pa
 Before starting, ensure you're familiar with:
 - [01 - Repository Overview](./01-repo-overview.md): Project structure and technology stack
 - [02 - Content Folder Guide](./02-content-folder.md): Content organization, front matter standards, and localization
-- [07 - Adding Blog Posts](./07-adding-blog-post.md): Use this instead when your change is in `content/posts/`
+- [04 - Adding Blog Posts](./04-adding-blog-post.md): Use this instead when your change is in `content/posts/`
 - Basic Next.js App Router concepts (routes, layouts, page components)
 
 This guide is for standard pages (`content/<slug>/index.md` + route files).  
-For posts in `content/posts/`, follow [07 - Adding Blog Posts](./07-adding-blog-post.md).
+For posts in `content/posts/`, follow [04 - Adding Blog Posts](./04-adding-blog-post.md).
 
 ## Step-by-Step Implementation Workflow
 

docs/07-adding-blog-post.md docs/04-adding-blog-post.mddocs/07-adding-blog-post.md renamed to docs/04-adding-blog-post.md

@@ -1,4 +1,4 @@
-# 07 - Adding Blog Posts
+# 04 - Adding Blog Posts
 
 ## Purpose
 
@@ -112,5 +112,5 @@ Reference them with web paths:
 ## Related Docs
 
 - [02 - Content Folder Guide](./02-content-folder.md)
-- [04 - First Contribution Checklist](./04-first-contribution-checklist.md)
-- [05 - Testing and Quality Checks](./05-testing-and-quality-checks.md)
+- [05 - First Contribution Checklist](./05-first-contribution-checklist.md)
+- [06 - Testing and Quality Checks](./06-testing-and-quality-checks.md)

docs/05-first-contribution-checklist.md

@@ -1,4 +1,4 @@
-# 04 - First Contribution Checklist
+# 05 - First Contribution Checklist
 
 ## Purpose and Scope
 
@@ -438,4 +438,4 @@ git push origin fix/issue-123-description
 - **Stuck on implementation?** → Check [01 - Repository Overview](./01-repo-overview.md)
 - **Content structure unclear?** → See [02 - Content Folder Guide](./02-content-folder.md)
 - **Adding a new page?** → Follow [03 - Adding Pages](./03-adding-pages.md)
-- **Build or test failures?** → Check [05 - Testing and Quality Checks](./05-testing-and-quality-checks.md)
+- **Build or test failures?** → Check [06 - Testing and Quality Checks](./06-testing-and-quality-checks.md)

docs/06-testing-and-quality-checks.md

@@ -1,4 +1,4 @@
-# 05 - Testing and Quality Checks
+# 06 - Testing and Quality Checks
 
 ## Overview
 

docs/07-github-automation.md

@@ -1,4 +1,4 @@
-# 06 - GitHub Automation Guide
+# 07 - GitHub Automation Guide
 
 ## Purpose and Scope
 
@@ -159,7 +159,7 @@ Welcome to your first contribution! Here's what you need to know:
 1. Start with: docs/README.md → "Getting Started"
 2. Next, read: docs/01-repo-overview.md
 3. For implementation help: see docs/03-adding-pages.md
-4. Before submitting PR: review docs/04-first-contribution-checklist.md
+4. Before submitting PR: review docs/05-first-contribution-checklist.md
 
 Questions? Ask here in the issue - maintainers are happy to help!
 ```
@@ -410,7 +410,7 @@ If you need to modify workflow behavior:
    - Ensure JSON is valid
 
 3. **Update this documentation**:
-   - In the same PR, update this file (06-github-automation.md)
+   - In the same PR, update this file (07-github-automation.md)
    - Explain what changed and why
    - Give examples if behavior is user-visible
 

docs/README.md

@@ -21,10 +21,10 @@ The following guides provide structured information organized by topic and use c
 | [01 - Repository Overview](./01-repo-overview.md) | Comprehensive overview of project structure, technology stack, and architectural patterns | All contributors |
 | [02 - Content Folder Guide](./02-content-folder.md) | Detailed explanation of content organization, markdown structure, and content management model | Content contributors, page editors |
 | [03 - Adding Pages](./03-adding-pages.md) | Step-by-step guide to implementing new pages including routing, content, and component integration | Feature developers, content editors |
-| [04 - First Contribution Checklist](./04-first-contribution-checklist.md) | Pre-submission validation checklist ensuring code quality, documentation completeness, and testing coverage | All contributors |
-| [05 - Testing and Quality Checks](./05-testing-and-quality-checks.md) | Comprehensive guide to automated testing, linting, build validation, and quality assurance procedures | Developers, QA reviewers |
-| [06 - GitHub Automation Guide](./06-github-automation.md) | Documentation of automated workflows, CI/CD processes, and GitHub Actions behavior | Maintainers, advanced contributors |
-| [07 - Adding Blog Posts](./07-adding-blog-post.md) | Dedicated workflow for post creation in `content/posts/`, including front matter, URL rules, and linking conventions | Content contributors, editors |
+| [04 - Adding Blog Posts](./04-adding-blog-post.md) | Dedicated workflow for post creation in `content/posts/`, including front matter, URL rules, and linking conventions | Content contributors, editors |
+| [05 - First Contribution Checklist](./05-first-contribution-checklist.md) | Pre-submission validation checklist ensuring code quality, documentation completeness, and testing coverage | All contributors |
+| [06 - Testing and Quality Checks](./06-testing-and-quality-checks.md) | Comprehensive guide to automated testing, linting, build validation, and quality assurance procedures | Developers, QA reviewers |
+| [07 - GitHub Automation Guide](./07-github-automation.md) | Documentation of automated workflows, CI/CD processes, and GitHub Actions behavior | Maintainers, advanced contributors |
 
 ## Getting Started: Recommended Reading Path
 
@@ -47,12 +47,12 @@ To successfully onboard and make your first contribution, please follow this rea
    - Learn the integration pattern between content and routing
    - Understand asset management
 
-4. **[07 - Adding Blog Posts](./07-adding-blog-post.md)** (5 min, when working on posts)
+4. **[04 - Adding Blog Posts](./04-adding-blog-post.md)** (5 min, when working on posts)
    - Learn the post-specific filename and front matter schema
    - Follow `/posts/...` routing conventions and linking rules
    - Avoid common metadata and visibility mistakes
 
-5. **[04 - First Contribution Checklist](./04-first-contribution-checklist.md)** (5 min)
+5. **[05 - First Contribution Checklist](./05-first-contribution-checklist.md)** (5 min)
    - Validate your work before submitting a pull request
    - Ensure all quality gates are met
    - Review PR submission requirements
@@ -61,9 +61,9 @@ To successfully onboard and make your first contribution, please follow this rea
 
 Consult these documents as needed while actively developing:
 
-- **[05 - Testing and Quality Checks](./05-testing-and-quality-checks.md)** - When running validation commands or debugging test failures
-- **[06 - GitHub Automation Guide](./06-github-automation.md)** - When troubleshooting CI failures or understanding review workflows
-- **[07 - Adding Blog Posts](./07-adding-blog-post.md)** - When adding or translating any file in `content/posts/`
+- **[06 - Testing and Quality Checks](./06-testing-and-quality-checks.md)** - When running validation commands or debugging test failures
+- **[07 - GitHub Automation Guide](./07-github-automation.md)** - When troubleshooting CI failures or understanding review workflows
+- **[04 - Adding Blog Posts](./04-adding-blog-post.md)** - When adding or translating any file in `content/posts/`
 
 ## Local Development Environment
 
@@ -172,7 +172,7 @@ All documentation updates must:
 ### Example Scenarios
 
 - **Adding a new configuration option?** → Update the relevant guide and include it in your PR alongside the code change
-- **Changing CI workflow?** → Update `06-github-automation.md` in the same PR
+- **Changing CI workflow?** → Update `07-github-automation.md` in the same PR
 - **Restructuring content organization?** → Update `02-content-folder.md` along with your code changes
 
 ## Common Workflow Patterns
@@ -181,30 +181,30 @@ All documentation updates must:
 
 1. Read [01 - Repository Overview](./01-repo-overview.md) to locate the relevant code
 2. Make your code changes and ensure they pass: `pnpm run lint && pnpm run build && pnpm run test:e2e`
-3. Use [04 - First Contribution Checklist](./04-first-contribution-checklist.md) before submitting the PR
+3. Use [05 - First Contribution Checklist](./05-first-contribution-checklist.md) before submitting the PR
 
 ### Adding or Updating Content
 
 1. Follow [02 - Content Folder Guide](./02-content-folder.md) for content structure
 2. Study [03 - Adding Pages](./03-adding-pages.md) if adding new pages
-3. Use [07 - Adding Blog Posts](./07-adding-blog-post.md) for any blog/article work in `content/posts/`
+3. Use [04 - Adding Blog Posts](./04-adding-blog-post.md) for any blog/article work in `content/posts/`
 4. Verify quality with the validation commands
-5. Reference [04 - First Contribution Checklist](./04-first-contribution-checklist.md) when ready to submit
+5. Reference [05 - First Contribution Checklist](./05-first-contribution-checklist.md) when ready to submit
 
 ### Implementing a Feature
 
 1. Start with [01 - Repository Overview](./01-repo-overview.md)
 2. Understand existing patterns in the codebase before implementing
 3. For frontend changes, refer to component patterns and TypeScript conventions
 4. Run full validation suite: `pnpm run lint && pnpm run build && pnpm run test:e2e`
-5. Follow the checklist in [04 - First Contribution Checklist](./04-first-contribution-checklist.md)
+5. Follow the checklist in [05 - First Contribution Checklist](./05-first-contribution-checklist.md)
 
 ## Support and Troubleshooting
 
-- **Build or test failures?** → Consult [05 - Testing and Quality Checks](./05-testing-and-quality-checks.md)
-- **Unsure about automation behavior?** → Review [06 - GitHub Automation Guide](./06-github-automation.md)
+- **Build or test failures?** → Consult [06 - Testing and Quality Checks](./06-testing-and-quality-checks.md)
+- **Unsure about automation behavior?** → Review [07 - GitHub Automation Guide](./07-github-automation.md)
 - **Need help with page structure?** → Check [03 - Adding Pages](./03-adding-pages.md) or [02 - Content Folder Guide](./02-content-folder.md)
-- **Need help with post metadata or `/posts/...` links?** → Check [07 - Adding Blog Posts](./07-adding-blog-post.md)
+- **Need help with post metadata or `/posts/...` links?** → Check [04 - Adding Blog Posts](./04-adding-blog-post.md)
 - **Repository questions?** → See [01 - Repository Overview](./01-repo-overview.md) for architecture and structure details
 
 ## Additional Resources