Skip to content

docs: add NOTES.md documentation and refresh template descriptions#67

Merged
nozaq merged 2 commits into
mainfrom
claude/devcontainer-template-descriptions-j0s3l7
Jul 14, 2026
Merged

docs: add NOTES.md documentation and refresh template descriptions#67
nozaq merged 2 commits into
mainfrom
claude/devcontainer-template-descriptions-j0s3l7

Conversation

@nozaq

@nozaq nozaq commented Jul 14, 2026

Copy link
Copy Markdown
Member

Summary

This PR adds comprehensive NOTES.md documentation files to all dev container templates and updates their descriptions in devcontainer-template.json files to be more descriptive and consistent.

Key Changes

  • Added NOTES.md files to all 10 templates (bun, debian, golang, mise, node, rust, terraform, uv, zig) with:

    • Security hardening overview (non-root user, capability dropping, init process, minimal base images)
    • Persistent cache documentation with volume mount tables
    • Usage notes and editor integration details specific to each template
    • Tips for common workflows (e.g., debugger setup, VS Code integration)
  • Updated template descriptions in devcontainer-template.json files:

    • Changed from generic "Minimal, supply-chain-secure" phrasing to more specific, benefit-focused descriptions
    • Descriptions now highlight key features (e.g., "hardened defaults", "persistent caches", "rebuild-friendly")
    • Increased max description length from 80 to 88 characters in CI validation to accommodate richer descriptions
  • Updated template versions (patch bumps) across all templates to reflect documentation additions

Notable Details

  • NOTES.md files follow a consistent structure across all templates with template-specific customizations
  • Documentation emphasizes security hardening as a core feature of these templates
  • Cache persistence information is presented in clear table format for easy reference
  • Each template's NOTES.md includes relevant editor integration details and practical tips

https://claude.ai/code/session_01LjtasUDz8tNuF7Nb1ZetRB

claude added 2 commits July 14, 2026 11:03
…saging

Rewrite each template's description around the security-focused messaging
introduced in the updated repository description and README intro, sync the
root README templates table to the same strings, bump each template's patch
version, and raise the CI description length limit from 80 to 88 characters.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LjtasUDz8tNuF7Nb1ZetRB
Document each template's security hardening, persistent cache volumes,
editor integration, and usage tips. The release workflow's generate-docs
step appends NOTES.md into the auto-generated per-template README.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LjtasUDz8tNuF7Nb1ZetRB
@nozaq nozaq changed the title Add NOTES.md documentation and refresh template descriptions docs: add NOTES.md documentation and refresh template descriptions Jul 14, 2026
@nozaq nozaq merged commit 7836ad1 into main Jul 14, 2026
31 of 32 checks passed
@nozaq nozaq deleted the claude/devcontainer-template-descriptions-j0s3l7 branch July 14, 2026 11:09
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