Skip to content

fix(cards): keep the blank line between the metadata list and the next heading - #71

Merged
dgrauet merged 1 commit into
mainfrom
fix/card-blank-line-before-usage
Jul 29, 2026
Merged

fix(cards): keep the blank line between the metadata list and the next heading#71
dgrauet merged 1 commit into
mainfrom
fix/card-blank-line-before-usage

Conversation

@dgrauet

@dgrauet dgrauet commented Jul 29, 2026

Copy link
Copy Markdown
Owner

Found by dry-running the ltx-2.3 card refresh before pushing it, not by reading the template.

1. A list running into a heading

The refresh would have published:

- **Model version:** 2.3.0
## Usage

No blank line — malformed markdown. {% endif -%} eats it, so the blank line has to be literal and inside the block, the same shape as the fix applied to the links and LoRA sections in #60.

Introduced when card generation moved to Jinja (2671caf); the published cards predate that and still have the blank line, which is why regenerating showed it as a removal.

Checked in all five shapes — metadata with and without a Usage section, a Usage section without metadata, neither, and quantized — because a literal blank line in the wrong place also appears when the block is absent. That is the failure mode of the previous attempt at this fix.

2. A warning that fired on a correction

The ltx refresh rewrites

-- **Transformer variants:** distilled, dev
+- **Transformer variants:** dev, distilled, distilled-1.1

which the dry run reported as content disappearing. The loss warning now pairs - **Label:** value lines on their label, as it already did for file entries. A warning that fires on an improvement trains you to ignore it, which defeats the point of having one.

Verification

755 tests pass; ruff and ty clean.

These fixes are already load-bearing

Four cards were published from this branch after dry-running each one:

Repo Change
matrix-game-3.0-mlx +4 google/umt5-xxl/* tokenizer files
ltx-2.3-mlx, -q4, -q8 the 1.1 transformer and its LoRA — in those repos since 22 April, mentioned in no section of the card

Each real diff matched its dry run exactly, with no losses.

🤖 Generated with Claude Code

https://claude.ai/code/session_01TaEHdLNyZuqjxqGmZ73JG9

…t heading

Dry-running the ltx-2.3 card refresh showed it would publish

    - **Model version:** 2.3.0
    ## Usage

with no blank line — a markdown list running into a heading. `{% endif -%}`
eats it, so the blank line has to be literal and inside the block, the same
shape as the links and LoRA sections. Introduced when card generation moved to
Jinja (2671caf); the published cards predate that and still have the blank
line.

Checked in all five shapes — metadata with and without a Usage section, a
Usage section without metadata, neither, and quantized — since a literal blank
line in the wrong place also appears when the block is absent.

Also pairs `- **Label:** value` lines in the dry run's loss warning. The ltx
refresh rewrites "Transformer variants: distilled, dev" as "dev, distilled,
distilled-1.1", which was being reported as content disappearing. A warning
that fires on a correction trains you to ignore it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TaEHdLNyZuqjxqGmZ73JG9
@dgrauet
dgrauet merged commit 870cf6d into main Jul 29, 2026
7 checks passed
@dgrauet
dgrauet deleted the fix/card-blank-line-before-usage branch July 29, 2026 18:53
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