Feat/doc site update

[ekizito96]

Pull Request

Description

Fixes the globe/world icon appearing on every sidebar nav item when the documentation site is deployed to nexus.developers.prescottdata.io.

Root cause: The ::before CSS selectors for the three Home external link icons (Website, Community, Blog) used substring href*= matching. In production, every internal nav link's href gets resolved by the browser to an absolute URL containing nexus.developers.prescottdata.io — so href*="developers.prescottdata.io" matched all of them, stamping the globe ::before icon on every single nav item. This was the identical bug fixed in JarvisCore at commit 165562b.

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation update
• Refactor

Changes Made

File	Summary
docs/stylesheets/extra.css	Changed all three ::before icon selectors from broad href*= substring matching to exact href= matching scoped to .md-sidebar--primary. Also added [target="_blank"] > svg { display: none } to suppress Material's injected globe SVG on external links.

Before (broken in production):

.md-nav__link[href*="developers.prescottdata.io"]:not([href*="blog"])::before,
.md-nav__link[href*="discord.gg"]::before,
.md-nav__link[href*="blog"]::before { ... }

After (exact match, scoped to primary sidebar):

.md-sidebar--primary .md-nav__link[href="https://developers.prescottdata.io"]::before,
.md-sidebar--primary .md-nav__link[href="https://discord.gg/AbskSXypq"]::before,
.md-sidebar--primary .md-nav__link[href="https://developers.prescottdata.io/blog"]::before { ... }

How to Test

1. Merge and deploy to nexus.developers.prescottdata.io
2. Open any doc page — sidebar nav items (Architecture, The Broker, Auth Strategies, etc.) should have only their frontmatter page icon, no globe
3. Expand the Home section — Website, Community, and Blog links should show their correct custom icons (globe, Discord, RSS) from the ::before pseudo-element, not on any other item
4. Verify locally at localhost:8001 — no visible change expected since the bug only manifests when the resolved href domain matches the pattern

Migration / Breaking Changes

• Database migration required
• No migration required

Checklist

• Commit messages use present tense, imperative mood, ≤72 chars
• No secrets or credentials committed
• Code follows the Go styleguide — N/A, CSS only
• Documentation updated where applicable — N/A, this is the docs site itself

[Copilot]

Pull request overview

Fixes a production-only bug where Material for MkDocs' globe icon (and a custom ::before icon) appeared on every sidebar item once the docs were served from nexus.developers.prescottdata.io. The broad href*= substring selectors matched browser-resolved absolute URLs of internal nav links, so the Home section's external-link icons were stamped on unrelated sidebar entries.

Changes:

• Replace href*= substring matching with exact href= matches for the Website, Community, and Blog ::before icons, scoped to .md-sidebar--primary.
• Update the Material globe-hiding rule to target the bare > svg direct child of .md-nav__link[target="_blank"] (instead of .md-nav__icon) so frontmatter page icons inside span.md-nav__icon are preserved.
• Refresh the explanatory block comment to describe the new DOM-structure-based approach.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.