Skip to content

docs(templates): add variable vs coder_parameter guidance, deprecated fields, registry PR conventions#3

Merged
DevelopmentCats merged 3 commits into
coder:mainfrom
bpmct:add-template-authoring-guidelines
Jun 3, 2026
Merged

docs(templates): add variable vs coder_parameter guidance, deprecated fields, registry PR conventions#3
DevelopmentCats merged 3 commits into
coder:mainfrom
bpmct:add-template-authoring-guidelines

Conversation

@bpmct

@bpmct bpmct commented Jun 3, 2026

Copy link
Copy Markdown
Member

Adds three sections to the templates skill based on patterns that come up when building real templates against a homelab Coder deployment.

Changes

variable vs coder_parameter — clarifies when each should be used. Infrastructure-level choices fixed per deployment (host arch, storage pool, remote host) belong in variable and are set by the admin at push time. Per-workspace choices (image, cpu, memory) belong in coder_parameter. Includes a concrete example and the push command with --variable.

Deprecated coder_agent fieldsdir is deprecated in recent provider versions, generates warnings on every coder templates push, and breaks Coder Desktop file sync. Worth calling out explicitly since it appears in older templates that get copied as a starting point.

Contributing templates to coder/registry — links to AGENTS.md and the PR template rather than duplicating them, and adds three non-obvious gotchas: no .tftest.hcl required for templates, the PR title convention (feat(<namespace>/templates/<name>): ...), and syncing the fork's main with upstream before branching to avoid a noisy diff.

Type of Change

  • New skill
  • Enhancement to existing skill
  • Bug fix
  • Documentation only

@bpmct bpmct marked this pull request as ready for review June 3, 2026 02:25
@bpmct bpmct requested a review from DevelopmentCats June 3, 2026 02:25

@DevelopmentCats DevelopmentCats left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@DevelopmentCats DevelopmentCats merged commit 0308038 into coder:main Jun 3, 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.

2 participants