Skip to content

Use '# Instructions' as the heading in description.md files - #2683

Merged
IsaacG merged 1 commit into
mainfrom
description-to-instructions-heading
Sep 17, 2026
Merged

IsaacG merged 1 commit into
mainfrom
description-to-instructions-heading

Conversation

@iHiD

@iHiD iHiD commented Sep 17, 2026

Copy link
Copy Markdown
Member

This changes the first line of each description.md from # Description to # Instructions.

When configlet generates a track's .docs/instructions.md from a description.md, it rewrites that heading, so every track copy differs from its source by one line. With this change the track copies are byte-identical to the source, which helps the translation effort: a translation of the source file can be reused for the track copy as-is.

Nothing downstream changes:

  • configlet only rewrites a file that starts with # Description. These files now pass through unchanged and produce the same output as before, so no track is flagged as unsynced.
  • The website strips the top-level heading before rendering, so nothing looks different.

90 files, one line each.

🤖 Generated with Claude Code

configlet rewrites this heading when generating a track's
.docs/instructions.md, so the track copy differs from the source by one
line. Using the final heading here makes the track copies byte-identical
to the source. configlet passes these files through unchanged, so no
track needs to re-sync.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@iHiD
iHiD requested a review from a team as a code owner September 17, 2026 15:36
@IsaacG
IsaacG merged commit 88744ce into main Sep 17, 2026
7 of 8 checks passed
@IsaacG
IsaacG deleted the description-to-instructions-heading branch September 17, 2026 17:16
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.

4 participants