Skip to content

Tighten Discord announce formatting (first-sentence teaser + NimbleBrain identity)#20

Merged
mgoldsborough merged 1 commit into
mainfrom
ci/announce-teaser-format
Jun 23, 2026
Merged

Tighten Discord announce formatting (first-sentence teaser + NimbleBrain identity)#20
mgoldsborough merged 1 commit into
mainfrom
ci/announce-teaser-format

Conversation

@mgoldsborough

Copy link
Copy Markdown
Contributor

Follow-up to #19. The first live post (screenshot context) was cluttered: the 280-char cap dumped the whole code-dense lead paragraph as a wall of gray pills, cut mid-sentence at "…resolved to…".

Change

First-sentence teaser instead of a char chunk. CHANGELOG leads open with clean prose; the inline-code-heavy detail comes later. Take the opening sentence (+ the second only if the first is terse and they still fit). Sentence boundaries are detected backtick-aware, so a . inside tokens.bgSubtle is never a false split. A 320-char word-boundary cap stays as a safety net.

Before → after, against the real v0.10.2 body:

Description
Before Fixes three `ui` tokens... `tokens.bgSubtle`, `tokens.fgFaint`, and `tokens.borderStrong` reference CSS vars (`--color-background-tertiary`, ...) that no host injected, so they always resolved to…
After Fixes three `ui` tokens that were theme-blind in dark mode.

Identity rebrand. Set the webhook username to NimbleBrain Releases so posts stop showing as "GitHub Releases". (The octocat avatar is the webhook's own avatar — set it in Discord → Edit Webhook to finish the rebrand; applies to all repos sharing the org webhook.)

Verified (dry-run, all paths)

  • v0.10.2 → clean one-sentence teaser, username: "NimbleBrain Releases".
  • Terse opener → pulls in the second sentence.
  • Lead-less body (### Fixed first) → ::warning:: + generic copy + link (unchanged).
  • biome clean.

Not changed

Crossposting: the channel is a Discord Announcement channel ("Publish" prompt), and webhooks can't auto-publish — that needs the bot upgrade, tracked separately with the shared-action extraction.

The mechanical 280-char cap produced a cluttered, pill-heavy block cut
mid-sentence (CHANGELOG leads are dense with backtick identifiers). Switch
to a first-sentence teaser: the opening sentence is clean prose, the
code-dense detail comes later. Sentence splitting is backtick-aware so a
`.` inside `tokens.bgSubtle` isn't a false boundary; a terse opener pulls
in the second sentence when it fits; a 320-char word-boundary cap remains
as a safety net.

Also set the webhook username to "NimbleBrain Releases" so posts stop
showing as "GitHub Releases" (the webhook's default identity). Avatar is
set on the webhook in Discord settings.
@mgoldsborough mgoldsborough merged commit 17bf204 into main Jun 23, 2026
5 checks passed
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