Skip to content

docs: add Infrahub Marketplace page#9366

Open
yjouffrault wants to merge 1 commit into
stablefrom
docs/migrate-marketplace
Open

docs: add Infrahub Marketplace page#9366
yjouffrault wants to merge 1 commit into
stablefrom
docs/migrate-marketplace

Conversation

@yjouffrault
Copy link
Copy Markdown
Contributor

Summary

  • Supersedes docs: add Infrahub Marketplace documentation #9093 — original content by Alex Gao, adapted for the revamped docs structure
  • New schema/marketplace/index.mdx: single-page merge of the original topic + how-to guide. Covers what the Marketplace is, namespace/name identifiers, semantic versioning, and the full fetch+load workflow (infrahubctl marketplace getinfrahubctl schema load) including version pinning, --stdout, and collection variants
  • Sidebar: Marketplace added under Schema & Data → Schema operations
  • Replaced all github.com/opsmill/schema-library references with Marketplace links: overview/concepts, overview/quickstart, overview/next-steps, schema/extensions, tutorials/getting-started/schema
  • Added "Load a schema" section + Marketplace tip to community and enterprise install pages (the original guides/installation.mdx has since moved to these two files)
  • Added stderr/stdin/stdout to Vale spelling exceptions
  • Added redirects-pending/marketplace.yml for URL tracking (will be aggregated at cleanup)

Why a new PR instead of merging #9093

PR #9093 was created before the docs revamp shipped. It adds content to topics/ and guides/ paths that no longer exist, and uses the old sidebar structure. This PR applies the same content to the correct new locations.

Test plan

  • Build passes: cd docs && npm run build
  • Lint passes: uv run invoke docs.lint
  • Browse to /schema/marketplace/ — page renders with concept intro and full workflow
  • Confirm Marketplace links work in quickstart, concepts, next-steps, schema extensions, getting-started tutorial
  • Confirm install pages (community + enterprise) show the "Load a schema" Marketplace tip

🤖 Generated with Claude Code

Integrates the Marketplace docs from PR #9093 into the revamped docs
structure using the single-page merge pattern:

- New `schema/marketplace/index.mdx` — merges the original topic and
  how-to guide into one page covering what the Marketplace is, how
  identifiers and versioning work, and the full fetch+load workflow
  (including version pinning, --stdout, and collection variants)
- Sidebar: Marketplace added to Schema & Data → Schema operations
- Replaces all Schema Library (github.com/opsmill/schema-library)
  references with Marketplace links across concepts, quickstart,
  next-steps, schema extensions, tutorials, and install pages
- Adds "Load a schema" + Marketplace tip to community and enterprise
  install pages (the file that PR #9093 targeted has since moved)
- Adds stderr/stdin/stdout to Vale spelling exceptions
- Adds redirects-pending/marketplace.yml for URL redirect tracking

Original content authored by Alex Gao. Closes #9093.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@yjouffrault yjouffrault requested review from a team as code owners May 27, 2026 19:25
@yjouffrault yjouffrault requested a review from BaptisteGi May 27, 2026 19:25
@github-actions github-actions Bot added the type/documentation Improvements or additions to documentation label May 27, 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.

1 issue found across 12 files

Confidence score: 4/5

  • This PR looks safe to merge overall, with only a minor documentation consistency risk rather than a runtime/code regression risk.
  • In docs/docs/overview/quickstart.mdx, dropping the uv run prefix on infrahubctl examples can mislead users in uv-managed Copier-template setups, potentially causing quickstart commands to fail or behave unexpectedly.
  • Given the issue is severity 4/10 and limited to docs usage guidance, the merge risk is minimal but worth a follow-up correction for smoother onboarding.
  • Pay close attention to docs/docs/overview/quickstart.mdx - ensure infrahubctl command prefixes are consistent with the rest of the quickstart instructions.
Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="docs/docs/overview/quickstart.mdx">

<violation number="1" location="docs/docs/overview/quickstart.mdx:90">
P2: The `infrahubctl` commands here dropped the `uv run` prefix that is consistently used for every other `infrahubctl` command in this document. In a uv-managed project created by the Copier template, these commands may fail with "command not found" when the user follows the tutorial.</violation>
</file>

Shadow auto-approve: would not auto-approve because issues were found.

Re-trigger cubic


```bash
uv run invoke schema-library-get
infrahubctl marketplace get opsmill/dcim
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

P2: The infrahubctl commands here dropped the uv run prefix that is consistently used for every other infrahubctl command in this document. In a uv-managed project created by the Copier template, these commands may fail with "command not found" when the user follows the tutorial.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/docs/overview/quickstart.mdx, line 90:

<comment>The `infrahubctl` commands here dropped the `uv run` prefix that is consistently used for every other `infrahubctl` command in this document. In a uv-managed project created by the Copier template, these commands may fail with "command not found" when the user follows the tutorial.</comment>

<file context>
@@ -80,31 +80,30 @@ You should see the Infrahub web interface with a navigation menu on the left sid
 
 ```bash
-uv run invoke schema-library-get
+infrahubctl marketplace get opsmill/dcim

</file context>


</details>

```suggestion
uv run infrahubctl marketplace get opsmill/dcim

@yjouffrault yjouffrault requested review from minitriga and removed request for a team and BaptisteGi May 27, 2026 19:37
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.

1 participant