Skip to content

Commit dde8db0

Browse files
WestwardWindsclaude
andcommitted
docs: build out the CAST PRO-1 section
Add the CAST PRO-1 pages modeled on the CAST-1 section: FAQ, getting started (labeled ports, USB-C power, Ethernet, hotspot and Improv setup, Audio Output), sensor definitions, ESPHome Device Builder, Analog In as a Music Assistant Sendspin Source, TTS and announcements, WizMote control, boot mode, reflash, boot button status check and factory reset, and teardown and reassembly. Expand the LED strip page with the Effect A and B slots, the pattern list, the photosensitivity warning, the LED Strip Test step, and a partition example for splitting the strip into segments. Add the hero image, labeled ports photo, hotspot onboarding clip, audio hookup clips, and teardown clips. Add a CAST PRO-1 naming rule to the style guide and AGENTS.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent db7a8ea commit dde8db0

26 files changed

Lines changed: 990 additions & 18 deletions

‎AGENTS.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,10 @@ Read the full style guide, but these are the ones worth checking twice:
2828

2929
- Product IDs are uppercase with a hyphen: **AIR-1**, **MTR-1**, never
3030
`Air-1` or `air1`.
31-
- **R PRO-1** is the exception: a space after the R, not a hyphen, in
32-
all display text. Keep `rpro1`, `r-pro-1`, and `R_PRO-1` only in file
33-
names, URLs, hostnames, and literal device names.
31+
- **R PRO-1** and **CAST PRO-1** are the exceptions: a space before
32+
PRO, not a hyphen, in all display text. Never `CAST-1 PRO`. Keep
33+
`rpro1`, `r-pro-1`, `R_PRO-1`, `castpro1`, and `cast-pro-1` only in
34+
file names, URLs, hostnames, entity IDs, and literal device names.
3435
- **US English** spelling: color, center, meter, behavior.
3536
- Flag must-know info with admonitions (`note` for prerequisites,
3637
`tip`, `warning`, `success` for a "Next step" box with a primary

‎STYLE_GUIDE.md‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ Product IDs are always uppercase with a hyphen: **AIR-1**, **MTR-1**,
105105
Never `Air-1`, `air1`, or `AIR1` in body copy. mkdocs.yml is the source
106106
of truth for the canonical form.
107107

108-
**R PRO-1** is the one exception: its name has a space after the R, not
108+
**R PRO-1** is an exception: its name has a space after the R, not
109109
a hyphen. Write **R PRO-1** in titles, headings, nav labels, and body
110110
copy, never `R-PRO-1`. The hyphenated and underscored forms survive
111111
only where a space isn't allowed or where you quote the device
@@ -117,6 +117,16 @@ literally, and those must not be changed:
117117
- The device name Home Assistant and Homey show: **Apollo R_PRO-1**
118118
- The setup hotspot: **Apollo R PRO 1 Hotspot**
119119

120+
**CAST PRO-1** follows the same pattern: a space after CAST, then
121+
**PRO-1**. Never `CAST-1 PRO`, `CAST-PRO-1`, or `Cast Pro`. It's a
122+
different product from the **CAST-1**, so don't shorten it to CAST-1.
123+
The same literal forms keep their own spelling:
124+
125+
- File and folder names and URLs: `castpro1/`, `cast-pro-1-intro-image.webp`
126+
- Entity IDs: `media_player.apollo_cast_pro_1_xxxxxx_player`
127+
- The device name Home Assistant and Music Assistant show: **Apollo CAST_PRO-1**
128+
- The setup hotspot: **Apollo CAST_PRO-1 Hotspot**
129+
120130
### First mention per page
121131

122132
On the first mention of a product in body copy, use the full brand name:
369 KB
Loading

‎docs/assets/cast-pro-1-hero.webp‎

194 KB
Loading
1.08 MB
Loading
1.22 MB
Loading

‎docs/assets/cast-pro-1-ports.webp‎

76.6 KB
Loading
29.6 KB
Loading
1000 KB
Loading
1010 KB
Loading

0 commit comments

Comments
 (0)