Skip to content

Add versioned docs infrastructure and fix broken site URL#34

Merged
AnExiledDev merged 2 commits intomainfrom
feat/versioned-docs
Feb 27, 2026
Merged

Add versioned docs infrastructure and fix broken site URL#34
AnExiledDev merged 2 commits intomainfrom
feat/versioned-docs

Conversation

@AnExiledDev
Copy link
Owner

@AnExiledDev AnExiledDev commented Feb 27, 2026

Summary

  • Fix broken docs site — the live site at codeforge.core-directive.com has broken styling/navigation because base: "/CodeForge" causes all CSS, JS, and link paths to 404 on the custom domain. Removed base and updated site to https://codeforge.core-directive.com
  • Versioned docs infrastructure — installed starlight-versions plugin and configured the versions content collection. Plugin is commented out (it requires ≥1 archived version); activation instructions are inline for when v3 development begins
  • Fixed all stale /CodeForge/ internal paths across astro.config.mjs head meta, Hero.astro, Header.astro, and index.mdx

Test plan

  • npm run build passes (40 pages, 0 errors)
  • starlight-links-validator reports all internal links valid
  • No version switcher visible (expected — plugin not active yet)
  • After deploy, verify codeforge.core-directive.com loads with proper styling
  • Verify internal navigation works (e.g., Getting Started, Plugins)

Summary by CodeRabbit

  • New Features

    • Added versioned documentation support (infrastructure prepared for future releases).
  • Bug Fixes

    • Fixed documentation site URL and removed legacy base path.
    • Updated documentation links and asset paths to work with the new site root.
  • Documentation

    • Updated changelog and docs to reflect versioning infrastructure, URL migration, and related content restructures.

Install starlight-versions plugin (commented out until first version
archive) and configure the versions content collection. Fix site URL
to codeforge.core-directive.com and remove /CodeForge base path,
updating all internal links and meta tag references.
@coderabbitai
Copy link

coderabbitai bot commented Feb 27, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 1043d92 and 85cb1e0.

📒 Files selected for processing (1)
  • .devcontainer/CHANGELOG.md

📝 Walkthrough

Walkthrough

Updates for the docs site: switched the site domain to https://codeforge.core-directive.com and removed the /CodeForge base path, added the starlight-versions dependency and loader to enable versioned docs, adjusted asset and internal links, and made minor component import/structure tweaks.

Changes

Cohort / File(s) Summary
Site configuration & changelog
docs/astro.config.mjs, .devcontainer/CHANGELOG.md
Changed site to https://codeforge.core-directive.com, removed base: "/CodeForge", updated asset paths (og-image, favicon, apple-touch-icon) to root; changelog updated to note versioned docs infra and site URL fix.
Dependencies
docs/package.json
Added starlight-versions dependency (^0.7.0).
Content loader & collections
docs/src/content.config.ts
Imported docsVersionsLoader and registered a new versions collection using docsVersionsLoader().
Components & navigation
docs/src/components/Header.astro, docs/src/components/Hero.astro
Normalized import quotes, added ThemeSelect and LanguageSelect to header right group, updated Docs/CTA links from /CodeForge/getting-started/ to /getting-started/, minor search condition string normalization.
Content pages
docs/src/content/docs/index.mdx, docs/src/content/docs/reference/changelog.md
Updated Get Started link URL and added/edited changelog entries documenting migration, CI/CD/docs fixes, and versioned docs notes.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Poem

🐰
Burrow packed with links anew,
I hopped the docs to a braver view—
Starlight versions tucked in my paw,
Rooted icons, paths I saw,
A tiny hop, a tidy crew. ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately and concisely summarizes the two main objectives: adding versioned docs infrastructure and fixing the broken site URL.
Description check ✅ Passed The description comprehensively covers the PR's purpose, includes a detailed test plan, and references the CHANGELOG update.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feat/versioned-docs

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
.devcontainer/CHANGELOG.md (1)

137-139: Merge duplicate ### Fixed sections in the Unreleased block.

This entry is currently under a second ### Fixed heading in the same release section; consolidating into one ### Fixed block will keep the changelog easier to scan.

As per coding guidelines: “Group changelog entries under appropriate headings: ### Added, ### Changed, ### Fixed, or ### Removed.”

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.devcontainer/CHANGELOG.md around lines 137 - 139, In the Unreleased
changelog block there are two separate "### Fixed" headings; consolidate them
into a single "### Fixed" section by merging the entries from the duplicate
heading into the existing "### Fixed" block (remove the extra "### Fixed" header
and any duplicate blank lines), ensure all fixed items are listed under that one
heading and preserve their order and formatting so the changelog complies with
the Added/Changed/Fixed/Removed grouping guideline.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In @.devcontainer/CHANGELOG.md:
- Around line 137-139: In the Unreleased changelog block there are two separate
"### Fixed" headings; consolidate them into a single "### Fixed" section by
merging the entries from the duplicate heading into the existing "### Fixed"
block (remove the extra "### Fixed" header and any duplicate blank lines),
ensure all fixed items are listed under that one heading and preserve their
order and formatting so the changelog complies with the
Added/Changed/Fixed/Removed grouping guideline.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8599b58 and 1043d92.

⛔ Files ignored due to path filters (1)
  • docs/package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (8)
  • .devcontainer/CHANGELOG.md
  • docs/astro.config.mjs
  • docs/package.json
  • docs/src/components/Header.astro
  • docs/src/components/Hero.astro
  • docs/src/content.config.ts
  • docs/src/content/docs/index.mdx
  • docs/src/content/docs/reference/changelog.md

Merge three separate ### Fixed headings into one to comply with
Keep a Changelog grouping conventions. Addresses CodeRabbit review.
@AnExiledDev AnExiledDev merged commit 59438d4 into main Feb 27, 2026
5 of 6 checks passed
@AnExiledDev AnExiledDev deleted the feat/versioned-docs branch February 27, 2026 02:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant