Skip to content

Regenerate tcld command reference docs#4778

Open
lennessyy wants to merge 5 commits into
mainfrom
fix/update-tcld-reference-docs
Open

Regenerate tcld command reference docs#4778
lennessyy wants to merge 5 commits into
mainfrom
fix/update-tcld-reference-docs

Conversation

@lennessyy

@lennessyy lennessyy commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Regenerate all tcld reference docs from the tcld repo source using a new gen-docs tool that walks the urfave/cli command tree.
  • Add missing pages: connectivity-rule, migration, service-account.
  • Update all existing pages to reflect current tcld command definitions.
  • Add missing sidebar entries for the new pages.

The gen-docs tool lives in the tcld repo at cmd/gen-docs/ (PR to follow).

Test plan

  • Preview all tcld reference pages render correctly
  • Verify new pages (migration, service-account, connectivity-rule) appear in sidebar
  • Spot-check a few commands against tcld --help output

┆Attachments: EDU-6604 Regenerate tcld command reference docs

Regenerate all tcld reference docs using a new gen-docs tool that
walks the urfave/cli command tree in the tcld repo. Adds missing
pages for connectivity-rule, migration, and service-account commands.
Updates all existing pages to reflect the current tcld command
definitions.
@lennessyy lennessyy requested a review from a team as a code owner June 26, 2026 18:12
@vercel

vercel Bot commented Jun 26, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Jun 26, 2026 9:58pm

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

Handle commands with empty Usage fields in gen-docs by providing a
fallback description string.
Angle brackets in flag usage text (e.g. <namespace>=<permission>) are
parsed as JSX tags by MDX, causing build failures. Escape them as
HTML entities.
MDX parses angle brackets as JSX tags and curly braces as expressions.
Escape both in flag usage text to prevent build failures.
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