SimplePixelFont · The-Nice-One · May 29, 2026 · Jun 5, 2026 · coderabbitai · Jun 5, 2026
diff --git a/package.json b/package.json
@@ -5,7 +5,8 @@
   "scripts": {
     "snippet:generate": "tsx scripts/snippet-tool.ts generate",
     "snippet:collapse": "tsx scripts/snippet-tool.ts collapse",
-    "snippet:expand": "tsx scripts/snippet-tool.ts expand"
+    "snippet:expand": "tsx scripts/snippet-tool.ts expand",
+    "snippet:document": "tsx scripts/snippet-tool.ts document"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",

diff --git a/scripts/snippet-tool.ts b/scripts/snippet-tool.ts
@@ -89,16 +89,21 @@ async function generateStructure(options: Record<string, string>) {
 
   for (const name of configurations) {
     await writePlaceholder(path.join(root, "configurations", "brief", toFileName(name)), name);
+    await writePlaceholder(path.join(root, "configurations", "condition", toFileName(name)), `${name} condition`);
+    await writePlaceholder(path.join(root, "configurations", "flag", toFileName(`use_${name}`)), `use_${name}`);
   }
   for (const name of links) {
     await writePlaceholder(path.join(root, "links", "brief", toFileName(name)), name);
+    await writePlaceholder(path.join(root, "links", "condition", toFileName(name)), `${name} condition`);
+    await writePlaceholder(path.join(root, "links", "flag", toFileName(`link_${name}`)), `link_${name}`);
   }
   for (const name of modifiers) {
     await writePlaceholder(path.join(root, "modifiers", "brief", toFileName(name)), name);
     await writePlaceholder(path.join(root, "modifiers", "details", toFileName(name)), `${name} details`);
   }
   for (const name of records) {
     await writePlaceholder(path.join(root, "records", "brief", toFileName(name)), name);
+    await writePlaceholder(path.join(root, "records", "condition", toFileName(name)), `${name} condition`);
   }
 
   console.log(`Generated snippet structure for table '${tableName}' at snippets/${tableName}`);
@@ -234,8 +239,8 @@ function generateConfigurationsSection(
   lines.push("| --- | ---- | ----------- |");
 
   for (let i = 0; i < configs.length; i++) {
-    const configBriefName = configs[i]; // e.g., "constant_codepoint_count"
-    const flagName = "use_" + configBriefName; // e.g., "use_constant_codepoint_count"
+    const configBriefName = configs[i]; // e.g., "constant_code_point_count"
+    const flagName = "use_" + configBriefName; // e.g., "use_constant_code_point_count"
     const flagPath = getRelativeSnippetPath(snippetType, "configurations/flag", flagName);
     lines.push(
       `| ${i} | \`${flagName}\` | \\textinput{${flagPath}} |`
@@ -370,7 +375,7 @@ async function generateDocument(options: Record<string, string>) {
 
   const tableDir = path.join(process.cwd(), "snippets", tableName);
   const outputPath = path.resolve(
-    options.output || path.join(process.cwd(), `${tableName}.md`)
+    options.output || path.join(process.cwd(), `src/${tableName}.md`)
   );
 
   // Check if table directory exists
@@ -424,7 +429,8 @@ async function generateDocument(options: Record<string, string>) {
   await fs.writeFile(outputPath, doc, "utf8");
 
   console.log(
-    `Generated document for table '${tableName}' at ${path.relative(process.cwd(), outputPath)}`
+    `Generated document for table '${tableName}' at ${path.relative(process.cwd(), outputPath)}
+    Make sure to reorder fields accordingly!`
   );
 }
 

diff --git a/snippets/character_table/configurations/brief/constant_code_point_count.md b/snippets/character_table/configurations/brief/constant_code_point_count.md
@@ -0,0 +1 @@
+The exact codepoint length of each `code_points` field in this table
diff --git a/snippets/character_table/configurations/brief/constant_codepoint_count.md b/snippets/character_table/configurations/brief/constant_codepoint_count.md
diff --git a/snippets/character_table/configurations/condition/constant_code_point_count.md b/snippets/character_table/configurations/condition/constant_code_point_count.md
@@ -0,0 +1 @@
+If `use_constant_code_point_count` is enabled.
diff --git a/snippets/character_table/configurations/condition/constant_codepoint_count.md b/snippets/character_table/configurations/condition/constant_codepoint_count.md
diff --git a/snippets/character_table/configurations/flag/use_constant_code_point_count.md b/snippets/character_table/configurations/flag/use_constant_code_point_count.md
@@ -0,0 +1 @@
+All characters in this table have the same number of code points.
diff --git a/snippets/character_table/configurations/flag/use_constant_codepoint_count.md b/snippets/character_table/configurations/flag/use_constant_codepoint_count.md
diff --git a/...aracter_table/records/brief/codepoints.md → ...racter_table/records/brief/code_points.md b/...aracter_table/records/brief/codepoints.md → ...racter_table/records/brief/code_points.md
diff --git a/...ter_table/records/condition/codepoints.md → ...er_table/records/condition/code_points.md b/...ter_table/records/condition/codepoints.md → ...er_table/records/condition/code_points.md
@@ -1 +1 @@
-UTF-8 encoded codepoint sequence (null-terminated unless `constant_codepoint_count` is set).
+UTF-8 encoded codepoint sequence (null-terminated unless `constant_code_point_count` is set).
diff --git a/snippets/color_table/brief.md b/snippets/color_table/brief.md
@@ -1,3 +1,6 @@
-# color_table table
+Stores RGBA color values that can be referenced by pixmap data.
 
-Write the documentation content for color_table table here.
+## Use Cases
+
+- **Pixmap palettes** - When linked to a Pixmap Table, provides the color palette for indexed pixel data.
+- **Color storage** - Can store color sets independently for other purposes.
diff --git a/snippets/color_table/configurations/brief/constant_alpha.md b/snippets/color_table/configurations/brief/constant_alpha.md
@@ -1,3 +0,0 @@
-# constant_alpha
-
-Write the documentation content for constant_alpha here.

diff --git a/snippets/color_table/configurations/condition/constant_alpha.md b/snippets/color_table/configurations/condition/constant_alpha.md
diff --git a/snippets/color_table/configurations/flag/use_constant_alpha.md b/snippets/color_table/configurations/flag/use_constant_alpha.md
diff --git a/snippets/color_table/records/condition/alpha.md b/snippets/color_table/records/condition/alpha.md
@@ -0,0 +1,3 @@
+# alpha
+
+Write the documentation content for alpha here.
diff --git a/snippets/color_table/records/condition/blue.md b/snippets/color_table/records/condition/blue.md
@@ -0,0 +1,3 @@
+# blue
+
+Write the documentation content for blue here.
diff --git a/snippets/color_table/records/condition/color_type.md b/snippets/color_table/records/condition/color_type.md
@@ -0,0 +1,3 @@
+# color_type
+
+Write the documentation content for color_type here.
diff --git a/snippets/color_table/records/condition/green.md b/snippets/color_table/records/condition/green.md
@@ -0,0 +1,3 @@
+# green
+
+Write the documentation content for green here.
diff --git a/snippets/color_table/records/condition/red.md b/snippets/color_table/records/condition/red.md
@@ -0,0 +1,3 @@
+# red
+
+Write the documentation content for red here.
diff --git a/snippets/font_table/links/condition/character_tables.md b/snippets/font_table/links/condition/character_tables.md
diff --git a/snippets/font_table/links/flag/link_character_tables.md b/snippets/font_table/links/flag/link_character_tables.md
diff --git a/snippets/font_table/records/condition/author.md b/snippets/font_table/records/condition/author.md
@@ -0,0 +1,3 @@
+# author
+
+Write the documentation content for author here.
diff --git a/snippets/font_table/records/condition/character_table_indexes.md b/snippets/font_table/records/condition/character_table_indexes.md
@@ -0,0 +1,3 @@
+# character_table_indexes
+
+Write the documentation content for character_table_indexes here.
-# character_table_indexes
-
-Write the documentation content for character_table_indexes here.
+# Character table indexes
+
+Write the documentation content for `character_table_indexes` here.
-# character_table_indexes
-
-Write the documentation content for character_table_indexes here.
+# Character table indexes
+
+Write the documentation content for `character_table_indexes` here.
diff --git a/snippets/font_table/records/condition/font_type.md b/snippets/font_table/records/condition/font_type.md
@@ -0,0 +1,3 @@
+# font_type
+
+Write the documentation content for font_type here.
-# font_type
-
-Write the documentation content for font_type here.
+# Font type
+
+Write the documentation content for `font_type` here.
-# font_type
-
-Write the documentation content for font_type here.
+# Font type
+
+Write the documentation content for `font_type` here.
diff --git a/snippets/font_table/records/condition/name.md b/snippets/font_table/records/condition/name.md
@@ -0,0 +1,3 @@
+# name
+
+Write the documentation content for name here.
diff --git a/snippets/font_table/records/condition/version.md b/snippets/font_table/records/condition/version.md
@@ -0,0 +1,3 @@
+# version
+
+Write the documentation content for version here.
diff --git a/snippets/pixmap_table/configurations/condition/constant_bits_per_pixel.md b/snippets/pixmap_table/configurations/condition/constant_bits_per_pixel.md
@@ -0,0 +1,3 @@
+# constant_bits_per_pixel
+
+Write the documentation content for constant_bits_per_pixel here.
diff --git a/snippets/pixmap_table/configurations/condition/constant_height.md b/snippets/pixmap_table/configurations/condition/constant_height.md
@@ -0,0 +1,3 @@
+# constant_height
+
+Write the documentation content for constant_height here.
diff --git a/snippets/pixmap_table/configurations/condition/constant_width.md b/snippets/pixmap_table/configurations/condition/constant_width.md
@@ -0,0 +1,3 @@
+# constant_width
+
+Write the documentation content for constant_width here.
diff --git a/snippets/pixmap_table/configurations/flag/use_constant_bits_per_pixel.md b/snippets/pixmap_table/configurations/flag/use_constant_bits_per_pixel.md
@@ -0,0 +1,3 @@
+# constant_bits_per_pixel
+
+Write the documentation content for constant_bits_per_pixel here.
diff --git a/snippets/pixmap_table/configurations/flag/use_constant_height.md b/snippets/pixmap_table/configurations/flag/use_constant_height.md
@@ -0,0 +1,3 @@
+# constant_height
+
+Write the documentation content for constant_height here.
diff --git a/snippets/pixmap_table/configurations/flag/use_constant_width.md b/snippets/pixmap_table/configurations/flag/use_constant_width.md
@@ -0,0 +1,3 @@
+# constant_width
+
+Write the documentation content for constant_width here.
diff --git a/snippets/pixmap_table/links/condition/color_tables.md b/snippets/pixmap_table/links/condition/color_tables.md
diff --git a/snippets/pixmap_table/links/flag/link_color_tables.md b/snippets/pixmap_table/links/flag/link_color_tables.md
diff --git a/snippets/pixmap_table/records/condition/bits_per_pixel.md b/snippets/pixmap_table/records/condition/bits_per_pixel.md
@@ -0,0 +1,3 @@
+# bits_per_pixel
+
+Write the documentation content for bits_per_pixel here.
diff --git a/snippets/pixmap_table/records/condition/data.md b/snippets/pixmap_table/records/condition/data.md
@@ -0,0 +1,3 @@
+# data
+
+Write the documentation content for data here.
diff --git a/snippets/pixmap_table/records/condition/height.md b/snippets/pixmap_table/records/condition/height.md
@@ -0,0 +1,3 @@
+# height
+
+Write the documentation content for height here.
diff --git a/snippets/pixmap_table/records/condition/width.md b/snippets/pixmap_table/records/condition/width.md
@@ -0,0 +1,3 @@
+# width
+
+Write the documentation content for width here.
diff --git a/src/Character Table.md b/src/Character Table.md
@@ -24,14 +24,14 @@
 
 | Bit | Name                           | Description                                                     |
 | --- | ------------------------------ | --------------------------------------------------------------- |
-| 0   | `use_constant_codepoint_count` | \textinput{../snippets/character_table/configurations/flag/use_constant_codepoint_count.md} |
+| 0   | `use_constant_code_point_count` | \textinput{../snippets/character_table/configurations/flag/use_constant_code_point_count.md} |
 | 1-7 | —                              | \textinput{../snippets/phrase/reserved.md}                                         |
 
 #### Configuration Values
 
 | Name                       | Type | Condition                                    | Description                                                         |
 | -------------------------- | ---- | -------------------------------------------- | ------------------------------------------------------------------- |
-| `constant_codepoint_count` | `u8` | \textinput{../snippets/character_table/configurations/condition/constant_codepoint_count.md} | \textinput{../snippets/character_table/configurations/brief/constant_codepoint_count.md} |
+| `constant_code_point_count` | `u8` | \textinput{../snippets/character_table/configurations/condition/constant_code_point_count.md} | \textinput{../snippets/character_table/configurations/brief/constant_code_point_count.md} |
 
 ### Table Links
 
@@ -54,8 +54,8 @@ Each character record contains the following fields in order:
 | -------------------- | -------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------- |
 | `advance_x`          | `u8`                 | \textinput{../snippets/character_table/records/condition/advance_x.md} | \textinput{../snippets/character_table/records/brief/advance_x.md}                     |
 | `pixmap_index`       | `u8`                 | \textinput{../snippets/character_table/records/condition/pixmap_index.md} | \textinput{../snippets/character_table/records/brief/pixmap_index.md}                                   |
-| `pixmap_table_index` | `Index<PixmapTable>` | \textinput{../snippets/character_table/records/condition/pixmap_table_index.md} | \textinput{../snippets/character_table/records/brief/pixmap_table_index.md}                                |
-| `codepoints`         | `str`                | \textinput{../snippets/character_table/records/condition/codepoints.md} | \textinput{../snippets/character_table/records/brief/codepoints.md} |
+| `pixmap_table_index` | `u8` | \textinput{../snippets/character_table/records/condition/pixmap_table_index.md} | \textinput{../snippets/character_table/records/brief/pixmap_table_index.md}                                |
+| `code_points`         | `String`                | \textinput{../snippets/character_table/records/condition/code_points.md} | \textinput{../snippets/character_table/records/brief/codepoints.md} |
 
 ### Record Layout Examples
 

diff --git a/src/Color Table.md b/src/Color Table.md
@@ -0,0 +1,70 @@
+\textinput{../snippets/color_table/brief.md}
+
+## Table Structure
+
+### Identifier
+- **Value**: `0x03`
+
+
+## Modifier Flags
+
+| Bit | Name | Description |
+| --- | ---- | ----------- |
+| 0 | `use_color_type` | \textinput{../snippets/color_table/modifiers/brief/use_color_type.md} |
+| 1-7 | — | \textinput{../snippets/phrase/reserved.md} |
+
+### Flag Details
+
+- **`use_color_type`**: \textinput{../snippets/color_table/modifiers/details/use_color_type.md}
+
+## Configuration Flags
+
+| Bit | Name | Description |
+| --- | ---- | ----------- |
+| 0 | `use_constant_alpha` | \textinput{../snippets/color_table/configurations/flag/use_constant_alpha.md} |
+| 1-7 | — | \textinput{../snippets/phrase/reserved.md} |
+
+### Configuration Values
+
+| Name | Type | Condition | Description |
+| ---- | ---- | --------- | ----------- |
+| `constant_alpha` | `u8` | \textinput{../snippets/color_table/configurations/condition/constant_alpha.md} | \textinput{../snippets/color_table/configurations/brief/constant_alpha.md} |
+
+## Record Fields
+
+
+Each record contains the following fields in order:
+
+| Field | Type | Condition | Description |
+| ----- | ---- | --------- | ----------- |
+| `color_type` | `[TYPE_PLACEHOLDER]` | \textinput{../snippets/color_table/records/condition/color_type.md} | \textinput{../snippets/color_table/records/brief/color_type.md} |
+| `alpha` | `[TYPE_PLACEHOLDER]` | \textinput{../snippets/color_table/records/condition/alpha.md} | \textinput{../snippets/color_table/records/brief/alpha.md} |
+| `red` | `[TYPE_PLACEHOLDER]` | \textinput{../snippets/color_table/records/condition/red.md} | \textinput{../snippets/color_table/records/brief/red.md} |
+| `green` | `[TYPE_PLACEHOLDER]` | \textinput{../snippets/color_table/records/condition/green.md} | \textinput{../snippets/color_table/records/brief/green.md} |
+| `blue` | `[TYPE_PLACEHOLDER]` | \textinput{../snippets/color_table/records/condition/blue.md} | \textinput{../snippets/color_table/records/brief/blue.md} |
+
+## Examples
+
+
+Provide example records demonstrating various field combinations:
+
+**Example 1: Minimal record** (no optional fields)
+```
+[EXAMPLE_PLACEHOLDER]
+```
+
+**Example 2: With optional fields**
+```
+[EXAMPLE_PLACEHOLDER]
+```
+
+
+## Complete Table Example
+
+
+The following byte sequence defines a minimal table with example records:
+
+| Byte(s) | Binary | Hex | Description |
+| ------- | ------ | --- | ----------- |
+| 1 | `[BINARY_PLACEHOLDER]` | `[HEX_PLACEHOLDER]` | Table identifier |
+| ... | ... | ... | [DESCRIPTION_PLACEHOLDER] |
-| Byte(s) | Binary | Hex | Description |
-| ------- | ------ | --- | ----------- |
-| 1 | `[BINARY_PLACEHOLDER]` | `[HEX_PLACEHOLDER]` | Table identifier |
-| ... | ... | ... | [DESCRIPTION_PLACEHOLDER] |
+| Bytes | Binary | Hex | Description |
+| ------- | ------ | --- | ----------- |
+| 1 | `[BINARY_PLACEHOLDER]` | `[HEX_PLACEHOLDER]` | Table identifier |
+| … | … | … | [DESCRIPTION_PLACEHOLDER] |
-| Byte(s) | Binary | Hex | Description |
-| ------- | ------ | --- | ----------- |
-| 1 | `[BINARY_PLACEHOLDER]` | `[HEX_PLACEHOLDER]` | Table identifier |
-| ... | ... | ... | [DESCRIPTION_PLACEHOLDER] |
+| Bytes | Binary | Hex | Description |
+| ------- | ------ | --- | ----------- |
+| 1 | `[BINARY_PLACEHOLDER]` | `[HEX_PLACEHOLDER]` | Table identifier |
+| … | … | … | [DESCRIPTION_PLACEHOLDER] |
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		The exact codepoint length of each `code_points` field in this table
Check failure on line 1 in snippets/character_table/configurations/brief/constant_code_point_count.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/character_table/configurations/brief/constant_code_point_count.md#L1 `[Vale.Spelling] Did you really mean 'codepoint'?` Raw output `{"message": "[Vale.Spelling] Did you really mean 'codepoint'?", "location": {"path": "snippets/character_table/configurations/brief/constant_code_point_count.md", "range": {"start": {"line": 1, "column": 11}}}, "severity": "ERROR"}`
Copy link Copy Markdown coderabbitai Bot Jun 5, 2026 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others. Learn more. ⚠️ Potential issue \| 🟠 Major \| ⚡ Quick win Resolve Vale spelling failure (`codepoint`). CI is failing on this line. Replace `codepoint` with `code point` (or project-approved term) to satisfy the linter. 🧰 Tools 🪛 GitHub Actions: vale / vale [error] 1-1: [Vale.Spelling] Did you really mean 'codepoint'? 🪛 GitHub Check: vale [failure] 1-1: [vale] snippets/character_table/configurations/brief/constant_code_point_count.md#L1 [Vale.Spelling] Did you really mean 'codepoint'? 🤖 Prompt for AI Agents Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@snippets/character_table/configurations/brief/constant_code_point_count.md` at line 1, Replace the misspelled term "codepoint" with the project-approved term "code point" in the documentation line that describes the exact codepoint length for the `code_points` field (the string containing "codepoint" in the brief description for constant_code_point_count). Update that single word so the sentence reads "code point" to satisfy the Vale linter.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		All characters in this table have the same number of code points.
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		UTF-8 encoded codepoint sequence (null-terminated unless `constant_codepoint_count` is set).
		UTF-8 encoded codepoint sequence (null-terminated unless `constant_code_point_count` is set).
Check notice on line 1 in snippets/character_table/records/condition/code_points.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/character_table/records/condition/code_points.md#L1 `[Google.Parens] Use parentheses judiciously.` Raw output `{"message": "[Google.Parens] Use parentheses judiciously.", "location": {"path": "snippets/character_table/records/condition/code_points.md", "range": {"start": {"line": 1, "column": 1}}}, "severity": "INFO"}` Check failure on line 1 in snippets/character_table/records/condition/code_points.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/character_table/records/condition/code_points.md#L1 `[Vale.Spelling] Did you really mean 'codepoint'?` Raw output `{"message": "[Vale.Spelling] Did you really mean 'codepoint'?", "location": {"path": "snippets/character_table/records/condition/code_points.md", "range": {"start": {"line": 1, "column": 15}}}, "severity": "ERROR"}` Check notice on line 1 in snippets/character_table/records/condition/code_points.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/character_table/records/condition/code_points.md#L1 `[write-good.E-Prime] Try to avoid using 'is'.` Raw output `{"message": "[write-good.E-Prime] Try to avoid using 'is'.", "location": {"path": "snippets/character_table/records/condition/code_points.md", "range": {"start": {"line": 1, "column": 86}}}, "severity": "INFO"}` Check notice on line 1 in snippets/character_table/records/condition/code_points.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/character_table/records/condition/code_points.md#L1 `[Google.Passive] In general, use active voice instead of passive voice ('is set').` Raw output `{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is set').", "location": {"path": "snippets/character_table/records/condition/code_points.md", "range": {"start": {"line": 1, "column": 86}}}, "severity": "INFO"}` Check warning on line 1 in snippets/character_table/records/condition/code_points.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/character_table/records/condition/code_points.md#L1 `[write-good.Passive] 'is set' may be passive voice. Use active voice if you can.` Raw output `{"message": "[write-good.Passive] 'is set' may be passive voice. Use active voice if you can.", "location": {"path": "snippets/character_table/records/condition/code_points.md", "range": {"start": {"line": 1, "column": 86}}}, "severity": "WARNING"}`
Copy link Copy Markdown coderabbitai Bot Jun 5, 2026 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others. Learn more. ⚠️ Potential issue \| 🟠 Major \| ⚡ Quick win Fix CI-blocking spelling in `code_points` condition text. Vale fails on `codepoint` here as well. Please switch to `code point` (or the repository’s accepted spelling). 🧰 Tools 🪛 GitHub Actions: vale / 1_vale.txt [error] 1-1: Vale.Spelling: Did you really mean 'codepoint'? 🪛 GitHub Actions: vale / vale [error] 1-1: [Vale.Spelling] Did you really mean 'codepoint'? 🪛 GitHub Check: vale [notice] 1-1: [vale] snippets/character_table/records/condition/code_points.md#L1 [Google.Parens] Use parentheses judiciously. [failure] 1-1: [vale] snippets/character_table/records/condition/code_points.md#L1 [Vale.Spelling] Did you really mean 'codepoint'? [notice] 1-1: [vale] snippets/character_table/records/condition/code_points.md#L1 [write-good.E-Prime] Try to avoid using 'is'. [notice] 1-1: [vale] snippets/character_table/records/condition/code_points.md#L1 [Google.Passive] In general, use active voice instead of passive voice ('is set'). [warning] 1-1: [vale] snippets/character_table/records/condition/code_points.md#L1 [write-good.Passive] 'is set' may be passive voice. Use active voice if you can. 🤖 Prompt for AI Agents Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@snippets/character_table/records/condition/code_points.md` at line 1, The phrase "codepoint" in the `code_points` condition text should use the repository's accepted spelling "code point"; update the string "UTF-8 encoded codepoint sequence (null-terminated unless `constant_code_point_count` is set)." to "UTF-8 encoded code point sequence (null-terminated unless `constant_code_point_count` is set)." in the `code_points` condition documentation so Vale no longer flags it.
Original file line number	Diff line number	Diff line change
		@@ -1,3 +0,0 @@
		# constant_alpha

		Write the documentation content for constant_alpha here.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# alpha
Check warning on line 1 in snippets/color_table/records/condition/alpha.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/color_table/records/condition/alpha.md#L1 `[Google.Headings] 'alpha' should use sentence-style capitalization.` Raw output `{"message": "[Google.Headings] 'alpha' should use sentence-style capitalization.", "location": {"path": "snippets/color_table/records/condition/alpha.md", "range": {"start": {"line": 1, "column": 3}}}, "severity": "WARNING"}`

		Write the documentation content for alpha here.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# blue
Check warning on line 1 in snippets/color_table/records/condition/blue.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/color_table/records/condition/blue.md#L1 `[Google.Headings] 'blue' should use sentence-style capitalization.` Raw output `{"message": "[Google.Headings] 'blue' should use sentence-style capitalization.", "location": {"path": "snippets/color_table/records/condition/blue.md", "range": {"start": {"line": 1, "column": 3}}}, "severity": "WARNING"}`

		Write the documentation content for blue here.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# color_type
Check failure on line 1 in snippets/color_table/records/condition/color_type.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/color_table/records/condition/color_type.md#L1 `[Vale.Spelling] Did you really mean 'color_type'?` Raw output `{"message": "[Vale.Spelling] Did you really mean 'color_type'?", "location": {"path": "snippets/color_table/records/condition/color_type.md", "range": {"start": {"line": 1, "column": 3}}}, "severity": "ERROR"}` Check warning on line 1 in snippets/color_table/records/condition/color_type.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/color_table/records/condition/color_type.md#L1 `[Google.Headings] 'color_type' should use sentence-style capitalization.` Raw output `{"message": "[Google.Headings] 'color_type' should use sentence-style capitalization.", "location": {"path": "snippets/color_table/records/condition/color_type.md", "range": {"start": {"line": 1, "column": 3}}}, "severity": "WARNING"}`

		Write the documentation content for color_type here.
Check failure on line 3 in snippets/color_table/records/condition/color_type.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/color_table/records/condition/color_type.md#L3 `[Vale.Spelling] Did you really mean 'color_type'?` Raw output `{"message": "[Vale.Spelling] Did you really mean 'color_type'?", "location": {"path": "snippets/color_table/records/condition/color_type.md", "range": {"start": {"line": 3, "column": 37}}}, "severity": "ERROR"}`
Comment on lines +1 to +3 Copy link Copy Markdown coderabbitai Bot Jun 5, 2026 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others. Learn more. ⚠️ Potential issue \| 🟠 Major \| ⚡ Quick win Replace underscore identifier prose to pass Vale (`color_type`). This file fails lint on `color_type`. Use human-readable text (e.g., “color type”) in heading/body while keeping schema identifiers in backticks only where necessary. 🧰 Tools 🪛 GitHub Actions: vale / 1_vale.txt [error] 1-1: Vale.Spelling: Did you really mean 'color_type'? [error] 3-3: Vale.Spelling: Did you really mean 'color_type'? 🪛 GitHub Actions: vale / vale [error] 1-1: [Vale.Spelling] Did you really mean 'color_type'? [error] 3-3: [Vale.Spelling] Did you really mean 'color_type'? 🪛 GitHub Check: vale [failure] 1-1: [vale] snippets/color_table/records/condition/color_type.md#L1 [Vale.Spelling] Did you really mean 'color_type'? [warning] 1-1: [vale] snippets/color_table/records/condition/color_type.md#L1 [Google.Headings] 'color_type' should use sentence-style capitalization. [failure] 3-3: [vale] snippets/color_table/records/condition/color_type.md#L3 [Vale.Spelling] Did you really mean 'color_type'? 🤖 Prompt for AI Agents Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@snippets/color_table/records/condition/color_type.md` around lines 1 - 3, Update the documentation so the heading and prose use human-readable text instead of the underscored identifier: change the heading from "# color_type" to something like "# Color type" and replace occurrences of plain `color_type` in the body with human-readable phrases such as "color type", reserving the backticked `color_type` only when referencing the exact schema identifier or code example; ensure the file still documents the schema named `color_type` but uses natural language for headings and explanatory sentences.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# green
Check warning on line 1 in snippets/color_table/records/condition/green.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/color_table/records/condition/green.md#L1 `[Google.Headings] 'green' should use sentence-style capitalization.` Raw output `{"message": "[Google.Headings] 'green' should use sentence-style capitalization.", "location": {"path": "snippets/color_table/records/condition/green.md", "range": {"start": {"line": 1, "column": 3}}}, "severity": "WARNING"}`

		Write the documentation content for green here.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# red
Check warning on line 1 in snippets/color_table/records/condition/red.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/color_table/records/condition/red.md#L1 `[Google.Headings] 'red' should use sentence-style capitalization.` Raw output `{"message": "[Google.Headings] 'red' should use sentence-style capitalization.", "location": {"path": "snippets/color_table/records/condition/red.md", "range": {"start": {"line": 1, "column": 3}}}, "severity": "WARNING"}`

		Write the documentation content for red here.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# author
Check warning on line 1 in snippets/font_table/records/condition/author.md View workflow job for this annotation GitHub Actions / vale [vale] snippets/font_table/records/condition/author.md#L1 `[Google.Headings] 'author' should use sentence-style capitalization.` Raw output `{"message": "[Google.Headings] 'author' should use sentence-style capitalization.", "location": {"path": "snippets/font_table/records/condition/author.md", "range": {"start": {"line": 1, "column": 3}}}, "severity": "WARNING"}`

		Write the documentation content for author here.