Skip to content

docs: no-GitHub install section; publish the admin guide PDF from CI - #27

Merged
cmpham merged 1 commit into
mainfrom
docs/no-github-install-and-guide-pdf
Oct 15, 2026
Merged

cmpham merged 1 commit into
mainfrom
docs/no-github-install-and-guide-pdf

Conversation

@cmpham

@cmpham cmpham commented Oct 15, 2026

Copy link
Copy Markdown
Collaborator

Why

A customer piloting the plugin has no GitHub. The admin guide only mentioned a ZIP upload in a troubleshooting tip, with stale claude.ai labels, and the PDF had to be rendered and emailed by hand.

What

  • Guide: new "Installing without GitHub" section (regional ZIP download from the public release, Organization settings → Plugins & skills → Add → Upload a plugin, Default access, re-upload on each release, per-user fallbacks). The GitHub route's labels are refreshed to Anthropic's current wording, the connector caveat is added to troubleshooting, and the references footer points at the current Anthropic pages.
  • CI: new guide.yml renders the PDF on pushes to main that touch the guide and attaches it to the release the guide names, so the current guide lives at a stable link: releases/latest/download/Anduin_MCP_Enablement_Guide_Claude.pdf. release.yml attaches the PDF to every new release too.
  • Scripts: --check also flags stale ZIP file names in the guide; render-guide.sh keeps Chrome's stderr in CI and fails on an empty output.
  • README and CLAUDE.md updated accordingly.

Verification

  • scripts/build-eu-plugin.sh --check passes; a planted stale ZIP name makes it fail.
  • scripts/render-guide.sh renders locally, with and without CI set.
  • Both regional ZIPs on the v0.10.0 release match a fresh local build byte for byte.

After merge, the guide workflow attaches the PDF to v0.10.0.

🤖 Generated with Claude Code

…rom CI

The admin guide gains an "Installing without GitHub" section: download the
regional ZIP from the public release, upload it in Organization settings >
Plugins & skills > Add > Upload a plugin, set Default access, and re-upload
on each release. The GitHub route's claude.ai labels are refreshed to
Anthropic's current wording (Plugins & skills, Sync from GitHub, Available
to install, Default access, Re-sync), the connector caveat is added to
troubleshooting, and the references point at the current Anthropic pages.

A new guide workflow renders the PDF on pushes to main that touch the guide
and attaches it to the release the guide names, so the current guide is
always at releases/latest/download/Anduin_MCP_Enablement_Guide_Claude.pdf.
The release workflow attaches the PDF to every new release as well, the
release check now flags stale ZIP names in the guide, and render-guide.sh
keeps Chrome's stderr in CI and fails on an empty output file.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@cmpham
cmpham merged commit ba33f6e into main Oct 15, 2026
1 check passed
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