Skip to content

Commit 89950d4

Browse files
TMHSDigitalclaude
andcommitted
docs: record the formats cleanup in the ledger
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Wc67NX9MM964uaVGn4bpZJ
1 parent 40a6010 commit 89950d4

1 file changed

Lines changed: 32 additions & 1 deletion

File tree

‎docs/review-ledger.md‎

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,36 @@ Newest section at the top. One section per review run. This is the record of wha
44
run measured, what it changed, what it deliberately did not change, and what the next
55
run should not spend time re-deciding.
66

7+
## 2026-09-23 (formats cleanup)
8+
9+
The previous section's next action: `formats` values that are not formats. One commit,
10+
`40a6010`, 20 entries.
11+
12+
- Removed where real formats were already listed: `many`, `runtime`, `shaders`,
13+
`spreadsheet`, `Kinect`, `model` (beside `ONNX`), `config`, `examples`, `binary`.
14+
- Software with no file format of its own now names a **delivery type**: `desktop-app`
15+
(5 entries), `mobile-app`, `cli` (2); `JS API` became the `JavaScript` target.
16+
- Moved to `tags`: `windows`, `macos`, `ios`, `heightfield`, and `variable` as
17+
`variable-font` on 5 fonts (Inter's existing `variable` tag renamed to match).
18+
- CONTRIBUTING now defines four kinds of `formats` value (file formats, engine or
19+
language targets, delivery types, `various` for aggregators) and no longer claims every
20+
extension is upper case, which `gdshader`, `tmx` and `ktx2` already contradicted.
21+
- Nothing invented: Gaea and Piper name no output format in their entries, so they get a
22+
delivery type rather than a guessed file type.
23+
- Not enforced by a check. The delivery-type list is short and could become a V13-style
24+
vocabulary later if it drifts.
25+
- **The review queue is now empty of work that does not need the maintainer.** What is
26+
left is three decisions, carried since the first run.
27+
- Next highest-value action: **the three maintainer decisions**, with a recommended
28+
default for each so a yes is enough:
29+
- `og:image`: a first-party 1200x630 PNG of the site under `docs/images/readme/`, the
30+
path the validator already allows for first-party stills. Hard rule 3 covers
31+
third-party binaries, not the project's own screenshot.
32+
- `data.json` (297 KB, unused by the page): keep it and document it in `site/README.md`
33+
as the catalog's public JSON endpoint. Removing it breaks anyone already using it.
34+
- `camera_perspective`: keep it 2D-only, and say so in TEMPLATE. `characters` and `3d`
35+
have no perspective in the 2D sense, and the View filter already explains itself.
36+
737
## 2026-09-23 (plural subcategories)
838

939
The previous section's next action: the five singular/plural subcategory pairs. One
@@ -20,7 +50,8 @@ commit, `48d3d4d`, because the stricter check fails without the data fix.
2050
- Process note: the mutation test was reverted with `git checkout`, which also reverted
2151
the uncommitted fix in that file. Caught by re-reading the file before commit. Revert a
2252
mutation with the inverse edit, not a checkout, while other changes are uncommitted.
23-
- Next highest-value action: **the `formats` values that are not formats** (`examples`,
53+
- Next highest-value action: ~~**the `formats` values that are not formats**~~ Done in
54+
the formats cleanup section above. (`examples`,
2455
`many`, `runtime`, `windows`, `macOS`, `iOS`, `library`, `binary` and similar). Move
2556
each to `tags` where it carries meaning, delete it where it does not, and say in
2657
CONTRIBUTING that platforms are tags. Small, but they show up in the search haystack and

0 commit comments

Comments
 (0)