Skip to content

Commit d0d0c53

Browse files
committed
Expand History, restructure Loading, switch to every-occurrence bolding
History section: - Add paragraphs on the 80's machine-language workflow and on Code Probe taking long enough to write that it became the only finished thing from the era; link the standalone 3D cube demo. - Reorder the C64 / SD-card paragraph to follow the new content. - Spelling and tense fixes (challenge, language, non-existent, together, fair, rarely, parameterised, isolation, close, basically, without; "had taken" not "has taken"). - Remove a double-linked Claude Code / Kick Assembler from the "In 2026" paragraph; first-mention link retained. Loading and Starting section: - Restructure "From the VICE Emulator" into three #### subsections (autostart PRG, autostart tape, attach-and-load-by-hand) with command lines indented under bullet points. - Add SYS 1152 as an alternative to RUN at the BASIC prompt. Quick Start: - Place Quick Start above Overview in the contents list. Inline-formatting convention change (CLAUDE.md + README.md): - Switch from "bold first prose use within a section" to "bold every prose occurrence" for the 19-name bold-list now defined in CLAUDE.md (Commodore VIC-20, VIC-20, VIC20, Commodore 64, C64, VIC-1211A Super Expander family, VICE, BASIC, Code Probe, TAPuino, SD2IEC, Pi1541, VICMON, HESMON, Super VICMON, TINYMON1). Possessive forms and link text included; headings, image alt text, code spans, code blocks, and URLs left unmodified.
1 parent 49d306c commit d0d0c53

2 files changed

Lines changed: 134 additions & 92 deletions

File tree

CLAUDE.md

Lines changed: 33 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -51,13 +51,41 @@ and apply symmetrically on the sibling `code-probe-c64` repository.
5151

5252
### Inline formatting
5353

54-
- Hardware names (`**Code Probe**`, `**VIC-20**`,
55-
`**VIC-1211A Super Expander**`, `**C64**`, `**BASIC**`) are bolded
56-
inline on first prose use within a section.
54+
- Hardware, peripheral, and product names from the bold-list below are
55+
bolded on **every prose occurrence**, including possessive forms
56+
(e.g. `**VIC-20's**`, `**Code Probe's**`, `**TAPuino's**`). The rule
57+
applies to first mentions, repeat mentions in the same paragraph,
58+
mentions inside link text, and mentions inside table cells. Earlier
59+
versions of this convention used "first prose use within a section";
60+
the rule changed to "every occurrence" on 2026-05-09 — see the
61+
edits-log A17 entry for the rationale.
62+
63+
**Bold-list** (longer phrases take precedence over the shorter forms
64+
they contain — bold the whole `**VIC-1211A Super Expander**`, not
65+
`**VIC-1211A** **Super Expander**`):
66+
67+
- **Commodore VIC-20**, **VIC-20**, **VIC20**
68+
- **Commodore 64**, **C64**
69+
- **VIC-1211A Super Expander**, **VIC-1211 Super Expander**,
70+
**Super Expander**, **VIC-1211A**, **VIC-1211**
71+
- **VICE**
72+
- **BASIC**
73+
- **Code Probe**
74+
- **TAPuino**, **SD2IEC**, **Pi1541**
75+
- **VICMON**, **HESMON**, **Super VICMON**, **TINYMON1**
76+
77+
- Bold applies only to prose. Names appearing inside backticked code
78+
spans (filenames, paths, commands, register names), code blocks,
79+
section/subsection headings, image alt text, or URLs are left
80+
unmodified — even when those tokens spell one of the listed names.
81+
- Bold inside link text is permitted: `[**Code Probe** (**C64**)](url)`,
82+
`[**Super Expander** ROM](#anchor)`.
5783
- Tools (`Kick Assembler`, `Claude Code`) are linked at first prose
5884
mention in each meaningful section, not just at first mention in the
59-
document. Bold-on-hardware-names and link-tools combine via
60-
`[**Tool Name**](url)`.
85+
document. Bare tool names (those not also on the bold-list) appear
86+
in link text plain: `[Claude Code](url)`. When a name is *both* a
87+
bold-list entry *and* a linked tool (currently only **VICE**), the
88+
patterns combine: `[**VICE**](url)`.
6189

6290
### Badges
6391

0 commit comments

Comments
 (0)