Skip to content

docs: fix Code Push casing and Fluter typo regression in FAQ#584

Merged
tomarra merged 1 commit into
mainfrom
docs/fix-faq-merge-regression
Jul 2, 2026
Merged

docs: fix Code Push casing and Fluter typo regression in FAQ#584
tomarra merged 1 commit into
mainfrom
docs/fix-faq-merge-regression

Conversation

@tomarra

@tomarra tomarra commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Status

READY

Description

A small but real regression on main right now: #581 (a typo fix, "Fluter" → "Flutter") was branched from content that predated #579 (proper-noun capitalization). Both PRs touched the same line in faq.mdx. By the time both merged, the line had reverted to the pre-#579 casing ("code push" lowercase) and the pre-#581 typo ("Fluter") — invisible in either PR's own diff, since it happened via merge ordering, not either PR's actual changes.

Found this while checking whether the content-guideline lint checks could be made blocking — it would have silently broken that effort, since Vale.Terms (proper-noun capitalization) runs at error severity and this line's lowercase "code push" would show up as an unexplained new failure with no obvious cause in the diff.

Test plan

  • npm run build succeeds

PR #581 (a typo fix based on pre-#579 content) and PR #579 (proper
noun capitalization) both touched this same line. Merge ordering
left the line with the pre-#579 casing and the pre-#581 typo, an
invisible regression since it wasn't part of either PR's diff by the
time both were merged. Restores both fixes.
@tomarra tomarra merged commit c032e75 into main Jul 2, 2026
3 checks passed
@tomarra tomarra deleted the docs/fix-faq-merge-regression branch July 2, 2026 18:45
tomarra added a commit that referenced this pull request Jul 2, 2026
Bumps both custom rules from warning to error severity and flips
fail_on_error to true in CI, so they now actually gate merges instead
of just annotating PRs.

Vale.Terms (proper-noun capitalization) is explicitly downgraded to
warning via `Vale.Terms = warning`, staying non-blocking. It doesn't
respect code-fence exclusion the way our custom scope:text rules do,
and a TokenIgnores pattern matching one occurrence of a shell command
(e.g. `shorebird release android`) intermittently fails to suppress a
second, identical occurrence elsewhere in the same file - confirmed
with minimal reproductions, not a config mistake. Findings are still
reported, just don't block.

Shorebird.SecondPerson stays at warning too, since that guideline's
content work hasn't happened yet.

IMPORTANT: this branch's own CI will fail until #583 (heading
sentence-case fixes) merges - this branch still has the original
Title Case headings. Do not merge this PR before #583. Verified the
full combination (this branch + main + #583 + #584) passes cleanly
with fail_on_error: true.
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