Skip to content

[Artifacts] Add Wrangler commands documentation#30827

Draft
dinasaur404 wants to merge 2 commits into
productionfrom
artifacts-wrangler-commands
Draft

[Artifacts] Add Wrangler commands documentation#30827
dinasaur404 wants to merge 2 commits into
productionfrom
artifacts-wrangler-commands

Conversation

@dinasaur404
Copy link
Copy Markdown
Contributor

Summary

Adds reference documentation for Artifacts Wrangler CLI commands. Users can now manage Artifacts namespaces, repositories, and repo-scoped tokens from the command line.

  • src/content/docs/workers/wrangler/commands/artifacts.mdx — Wrangler commands reference under the Workers section
  • src/content/docs/artifacts/api/wrangler.mdx — Wrangler commands reference under the Artifacts API section
  • src/content/partials/workers/wrangler-commands/artifacts.mdx — Shared partial with command details, options, and examples

Screenshots (optional)

Documentation checklist

@github-actions github-actions Bot added product:workers Related to Workers product size/m labels May 14, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 14, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/docs/artifacts/ @elithrar, @dmmulroy, @mattzcarey, @dinasaur404, @whoiskatrin, @cloudflare/product-owners
/src/content/docs/workers/wrangler/ @cloudflare/wrangler, @irvinebroque, @cloudflare/product-owners, @MattieTK
/src/content/partials/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @cloudflare/wrangler, @MattieTK

Comment thread src/content/docs/artifacts/api/wrangler.mdx
@ask-bonk ask-bonk Bot added documentation Documentation edits content:new Request for new/missing content labels May 14, 2026
Copy link
Copy Markdown
Contributor

@ask-bonk ask-bonk Bot left a comment

Choose a reason for hiding this comment

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

2 suggestions posted inline.

MEDIUMInlineBadge preset="beta" text="Private beta" renders as "Beta" because the preset overrides the text prop. Use variant="caution" instead if you want "Private beta".

LOW — Unused Render import in the partial.

Also note: the documentation checklist leaves the changelog entry unchecked. If this feature is customer-facing, consider adding one so it surfaces in RSS/Discord.


import { Render, InlineBadge } from "~/components";

Manage [Artifacts](/artifacts/) namespaces, repositories, and repo-scoped tokens using Wrangler. <InlineBadge preset="beta" text="Private beta" />
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.

<InlineBadge> overrides text when preset is set. To display "Private beta", remove preset:

Suggested change
Manage [Artifacts](/artifacts/) namespaces, repositories, and repo-scoped tokens using Wrangler. <InlineBadge preset="beta" text="Private beta" />
Manage [Artifacts](/artifacts/) namespaces, repositories, and repo-scoped tokens using Wrangler. <InlineBadge text="Private beta" variant="caution" />

{}
---

import { Render, AnchorHeading, Type, MetaInfo } from "~/components";
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.

Remove unused import:

Suggested change
import { Render, AnchorHeading, Type, MetaInfo } from "~/components";
import { AnchorHeading, Type, MetaInfo } from "~/components";

@ask-bonk
Copy link
Copy Markdown
Contributor

ask-bonk Bot commented May 14, 2026

Done. Here's the review summary for PR #30827:

Labels applied: documentation, product:workers, content:new (size/m was auto-applied by the repository).

Findings:

  • MEDIUMsrc/content/docs/workers/wrangler/commands/artifacts.mdx line 11: <InlineBadge preset="beta" text="Private beta" /> renders as "Beta" because the preset prop internally overrides text. Posted an inline suggestion to change it to <InlineBadge text="Private beta" variant="caution" />.
  • LOWsrc/content/partials/workers/wrangler-commands/artifacts.mdx line 5: Unused Render import. Posted an inline suggestion to remove it.
  • Note — The changelog entry in the PR checklist is unchecked. Since this is new feature documentation, consider adding a changelog entry if the feature is customer-facing.

What passes:

  • Frontmatter is valid and complete.
  • Heading hierarchy is correct (H1 → H2 → H3).
  • Internal links use absolute paths without extensions.
  • sh output code fences are valid (language = sh, meta = output — handled by the output-frame plugin).
  • MDX special characters are properly escaped or inside code blocks.
  • Component imports are correct.

github run

Copy link
Copy Markdown
Contributor

@irvinebroque irvinebroque left a comment

Choose a reason for hiding this comment

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

include changelog but otherwise lgtm

{}
---

import { Render, AnchorHeading, Type, MetaInfo } from "~/components";
Copy link
Copy Markdown
Collaborator

@kodster28 kodster28 May 14, 2026

Choose a reason for hiding this comment

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

Is there a reason you aren't doing this via WranglerCommand and/or WranglerNamespace components directly?

You may need to bump wrangler version in docs for this to work.

@dinasaur404
Copy link
Copy Markdown
Contributor Author

Addressed all feedback in the latest push:

  • @elithrar — Added a :::note with the minimum Wrangler version (4.91.0) to both pages.
  • @kodster28 — Bumped wrangler to 4.91.0 and switched artifacts/api/wrangler.mdx to use WranglerNamespace. The partial is still used for the workers commands page since both rendering paths are useful.
  • ask-bonk — Fixed InlineBadge to use variant="caution" instead of preset="beta", and removed the unused Render import from the partial.
  • @irvinebroque — Added a changelog entry for May 15.

- Add wrangler commands reference page at workers/wrangler/commands/artifacts
- Add wrangler commands page at artifacts/api/wrangler using shared partial
- Fix InlineBadge to use variant=caution so Private beta text renders
- Remove unused Render import from partial
- Add changelog entry for May 15
@dinasaur404 dinasaur404 force-pushed the artifacts-wrangler-commands branch from 2f0b786 to c326d80 Compare May 14, 2026 21:38
@dinasaur404
Copy link
Copy Markdown
Contributor Author

Updated — dropped the wrangler version bump and switched back to the Render partial for now. The artifacts namespace is not yet in any published wrangler version (checked through 4.91.0), so WranglerNamespace throws Namespace "artifacts" not found at build time. We will switch to WranglerNamespace in a follow-up once the wrangler release with the artifacts command registry ships.

Merge conflict is also resolved — rebased onto production.

@@ -0,0 +1,21 @@
---
title: Wrangler support for Artifacts
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.

what is wrangler

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content:new Request for new/missing content documentation Documentation edits product:workers Related to Workers product size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.