Skip to content

Describe the US layout in CLAUDE.md's template section - #39

Draft
MaxGhenis wants to merge 1 commit into
mainfrom
claude-md-us-layout
Draft

MaxGhenis wants to merge 1 commit into
mainfrom
claude-md-us-layout

Conversation

@MaxGhenis

Copy link
Copy Markdown
Contributor

WIP: draft until an independent review agrees.

Why

The "Newsletter Template Structure" section of CLAUDE.md called the 20 and 26 October editions "the two latest", although two 29 October editions have landed since. It also called the UK layout "the current template". A US edition doesn't use that layout, so anyone building one from this section would follow the wrong page colour, logo, type sizes and media query.

What changes

Docs only. This PR touches CLAUDE.md and no edition file.

  • The section now opens by saying that UK and US editions use different layouts, and which subsections describe which.
  • A new "US layout" subsection compares the two layouts element by element, then lists what only the US layout has: colour-scheme metas, its media query, the callout panel, jump links, the ARCHIVE and FORWARD merge tags, and four more palette colours with their ui-kit tokens.
  • A new "The 29 October UK edition" subsection lists what 2026-10-29-uk.html adds to the UK layout: full-width images with .text-pad, Mailchimp-hosted images, teal bullets and two wording changes.
  • "Images" now names those Mailchimp-hosted images as the exception to commit pinning, and names teal.png as the US logo. The "Logo format" bullet does too.
  • "Creating New Newsletters" keeps the "always start from the most recent newsletter" rule and now says to take the most recent edition for the same audience.
  • The palette row for the postal address no longer has a merge tag in a table cell, because GitHub splits table cells on its pipes.

Verification

  • bash scripts/lint-newsletters.sh passes.
  • A throwaway script checked the new text against the editions it describes: every code span in the comparison table against the matching layout, the US media-query block line by line, the "only the US layout" claims against all three UK editions, the image pinning of all five, the Mailchimp image count, and the four new tokens against src/theme/tokens.css in @policyengine/ui-kit (origin/main at 6e6630d).

This doesn't overlap #38, which edits the automations list further down the same file.

🤖 Generated with Claude Code

The section called the 20 and 26 October editions "the two latest",
although two 29 October editions have landed, and it called the UK
layout "the current template". US editions use a different layout.

Say which subsections describe which layout, compare the two element
by element, and list what only the US layout has. List what
2026-10-29-uk.html adds to the UK layout. Tell authors to copy the most
recent edition for the same audience.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.

1 participant