Skip to content

ESC docs: drive provider/rotator schema-reference tables from a data source #19792

Description

@jkodroff

Follow-up from #19691 (and related to #19690).

Problem

The schema-reference tables on ESC provider and rotator pages (Inputs / State / Outputs and their nested type tables) are hand-authored Markdown today. This makes them:

  • Inconsistent in column headers and ordering across pages.
  • Easy to drift out of sync with the actual provider/rotator schemas.
  • Tedious to maintain when a schema changes.

During #19691 the rotator tables were normalized by hand, but the underlying maintainability problem remains.

Proposal

Introduce a data-driven schema-reference structure for ESC provider/rotator pages:

  • Store provider/rotator schemas in a data/ source (single source of truth).
  • Render the Inputs/State/Outputs tables via a Hugo shortcode that consumes that data.
  • Derive the schema from the Pulumi Cloud REST API docs (the rotator/provider schemas are described there).

This mirrors how other generated reference content works on the site and removes the hand-maintained tables.

Notes

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/automationIssues relating to automation (mostly GHA workflows) and automatically generated contentarea/docs-contentIssues relating to content under pulumi.com/docs
    No fields configured for Enhancement.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions