Skip to content

docs: fix broken relative links on schema marketplace page#9388

Open
petercrocker wants to merge 1 commit into
stablefrom
docs/fix-marketplace-broken-links
Open

docs: fix broken relative links on schema marketplace page#9388
petercrocker wants to merge 1 commit into
stablefrom
docs/fix-marketplace-broken-links

Conversation

@petercrocker
Copy link
Copy Markdown
Contributor

@petercrocker petercrocker commented May 29, 2026

Problem

The docs build (and the downstream infrahub-docs aggregation build) fails with broken-link errors on the schema marketplace page:

- Broken link on source page path = /schema/marketplace:
   -> linking to ../create-and-load (resolved as: /create-and-load)
   -> linking to ../extensions (resolved as: /extensions)

Cause

docs/docs/schema/marketplace/index.mdx is an index.mdx, so its route is /schema/marketplace. The Related resources links used extensionless relative paths (../overview, ../create-and-load, ../extensions). Docusaurus resolves extensionless links URL-relative against the route, so a single ../ overshoots past /schema/ to the site root, producing /create-and-load and /extensions (which don't exist). ../overview happened to resolve to the unrelated /overview section page, masking a third latent mis-link.

Fix

Add the .mdx extension so the links resolve file-relative to the sibling pages in docs/docs/schema/, matching the convention already used elsewhere in this same file (e.g. the prerequisites link to ../../deploy-manage/install-configure/install/overview.mdx).

Validation

Verified the corrected paths point at existing sibling files (overview.mdx, create-and-load.mdx, extensions.mdx). The equivalent fix was confirmed to clear the broken-link build failure in the infrahub-docs aggregation repo.


Summary by cubic

Fix broken links on the Schema Marketplace page by adding .mdx so Docusaurus resolves them file‑relative. Also adds LDAP login and auto‑create groups, moves merge to the database, and auto‑discovers migrations with a cleaner CLI.

Written for commit 1843a1e. Summary will update on new commits.

Review in cubic

@github-actions github-actions Bot added the type/documentation Improvements or additions to documentation label May 29, 2026
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

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

No issues found across 1 file

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Shadow auto-approve: would auto-approve. This documentation-only change fixes three broken relative links by adding .mdx extensions, which resolves a build error and has no impact on any code, business logic, or infrastructure.

Re-trigger cubic

@petercrocker petercrocker changed the base branch from develop to stable May 29, 2026 11:02
@github-actions github-actions Bot added group/backend Issue related to the backend (API Server, Git Agent) group/frontend Issue related to the frontend (React) type/spec A specification for an upcoming change to the project labels May 29, 2026
The Related resources links used extensionless relative paths
(../overview, ../create-and-load, ../extensions). Because the page is
an index.mdx, Docusaurus resolves these URL-relative against the
/schema/marketplace route and overshoots to the site root, producing
broken links (/create-and-load, /extensions) that fail the docs build.

Add the .mdx extension so the links resolve file-relative, matching the
existing convention used elsewhere in the same file.
@petercrocker petercrocker force-pushed the docs/fix-marketplace-broken-links branch from 1843a1e to 45c06f5 Compare May 29, 2026 11:04
@github-actions github-actions Bot removed group/backend Issue related to the backend (API Server, Git Agent) group/frontend Issue related to the frontend (React) type/spec A specification for an upcoming change to the project labels May 29, 2026
@petercrocker petercrocker marked this pull request as ready for review May 29, 2026 11:20
@petercrocker petercrocker requested review from a team as code owners May 29, 2026 11:20
@petercrocker petercrocker requested review from BaptisteGi and wvandeun and removed request for a team May 29, 2026 11:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type/documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants