docs: always capitalize Shorebird, Flutter, and Code Push#579
Merged
Conversation
Per the marketing content guidelines, these are proper nouns and should always be capitalized. Fixes 52 instances across 16 files where they appeared lowercase or partially-cased in prose, headings, and frontmatter descriptions. Left 15 occurrences untouched because they're not brand-name prose mentions: - Domain names and email addresses (console.shorebird.dev, contact@shorebird.dev, download.flutter.dev) - The shorebird.yaml config filename - A GitHub issue shorthand reference (shorebirdtech/shorebird#3715) - A file path placeholder (/path/to/flutter) - Literal shell commands inside fenced code blocks (shorebird release android, shorebird patch android --track=staging) — Vale.Terms doesn't respect code-fence exclusion the way custom scope:text rules do, so these were manually verified and excluded
3 tasks
dawn-ducky
approved these changes
Jul 2, 2026
1 task
tomarra
added a commit
that referenced
this pull request
Jul 2, 2026
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Status
READY
Description
Per the marketing content guidelines (see #576), "Shorebird", "Flutter", and "Code Push" are proper nouns and should always be capitalized. This fixes 52 instances across 16 files where they appeared lowercase or partially-cased, in prose, headings, and frontmatter
descriptionfields.Left untouched (15 occurrences) — these are Vale false positives, not brand-name prose mentions:
console.shorebird.dev,contact@shorebird.dev,download.flutter.devshorebird.yamlconfig filename mentioned in proseshorebirdtech/shorebird#3715/path/to/fluttershorebird release android) — worth flagging to reviewers: Vale's built-inVale.Termsrule (unlike our custom rules) does not reliably respect code-fence exclusion, so these had to be found and excluded by hand. Something to watch for if this check gets automated/blocking later.Judgment calls worth a second look during review:
percentage-based-rollouts.mdx) — capitalizing the brand name reads slightly unusually right before a CLI subcommand name. Flagging in case marketing prefers a different phrasing here.This is one of several small content PRs split out of #576 so the
Vale.Termscheck can eventually be made blocking without a giant, hard-to-review PR.Test plan
npm run buildsucceeds, no broken linkscspellpasses on all touched files