Skip to content

Tidy example READMEs and document conventions - #2998

Merged
cnunciato merged 2 commits into
masterfrom
cnunciato/consistent-example-readmes
Sep 8, 2026
Merged

Tidy example READMEs and document conventions#2998
cnunciato merged 2 commits into
masterfrom
cnunciato/consistent-example-readmes

Conversation

@cnunciato

@cnunciato cnunciato commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Updates all READMEs to align with a consistent, type-appropriate structure (deployable, non-deployable, and multi-project index), adds template: blocks so the deploy button works on all deployable examples, applies sentence-case headings per the brand guidelines, and matches prerequisites and install steps to each project's runtime. Also updates CONTRIBUTING.md, the README template, and AGENTS.md to document the conventions.

Reshapes every example's README to a consistent, type-appropriate structure
(deployable, non-deployable, and multi-project index), adds template blocks so
the deploy button works on all deployable examples, applies sentence-case
headings per the brand guidelines, and matches prerequisites and install steps
to each project's runtime. Also updates CONTRIBUTING.md, the README template,
and AGENTS.md to document the standard.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cnunciato cnunciato changed the title Standardize example READMEs and document the conventions Tighten example READMEs and document conventions Sep 7, 2026
@cnunciato
cnunciato marked this pull request as ready for review September 7, 2026 13:43
@cnunciato
cnunciato requested a review from jkodroff as a code owner September 7, 2026 13:43
@cnunciato cnunciato changed the title Tighten example READMEs and document conventions Tidy example READMEs and document conventions Sep 7, 2026
Points all Install Pulumi, language, and Docker prerequisite links at a single
canonical URL each, lowercases the credentials link text for sentence-case
consistency, and records the canonical prerequisite links in AGENTS.md and the
README template.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cnunciato
cnunciato merged commit d34d9c1 into master Sep 8, 2026
54 of 60 checks passed
@cnunciato
cnunciato deleted the cnunciato/consistent-example-readmes branch September 8, 2026 14:12
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.

2 participants