Skip to content

copy: use "Donation Button" consistently across UI and docs - #9

Merged
pretyflaco merged 1 commit into
mainfrom
copy/donation-button-consistency
Jul 20, 2026
Merged

pretyflaco merged 1 commit into
mainfrom
copy/donation-button-consistency

Conversation

@pretyflaco

Copy link
Copy Markdown
Collaborator

What

The generator page shipped mixed product-name copy. The browser-tab <title>, meta description, and OG/Twitter share cards already said "Donation Button", but the visible <h1> headline said "Pay Button" — plus several docs and test pages were inconsistent.

We go to market as "Donation Button", so this makes the product-name copy consistent everywhere it's user-facing.

Changed (user-facing / marketing copy)

  • index.html <h1>: Blink Pay Button Generator → Blink Donation Button Generator
  • js/generator.js: the embed-snippet comments a user copies (<!-- Blink Donation Button widget/script -->) + file header
  • README.md, MULTILANG-README.md, ANALYTICS-README.md, USD-invoice guide headings
  • *-test.html titles/headings + wordpress-test-snippet.html comment
  • package.json description

Deliberately NOT changed (code identity / API / legal — per AGENTS.md guardrails)

  • Public API window.BlinkPayButton / BlinkPayButton.init
  • blink-pay-button-container id, .blink-pay-* CSS classes
  • js/blink-pay-button.js filename, header comment, and console.error debug strings (touching the widget file would also trigger a version bump for a non-behavior change)
  • LICENSE copyright attribution
  • referral=embedded_donation_button analytics value (data contract)

Testing

  • No behavior change (copy + comments only).
  • npm test green — 86 passing.

Part 1 of 2. Part 2 (username deep-linking, e.g. /pretyflaco) follows in a separate PR.

The generator page had mixed product-name copy: the <title>, meta/OG/
Twitter tags said "Donation Button" while the visible <h1> and various
docs/test pages said "Pay Button". We go to market as "Donation Button",
so make the product-name copy consistent.

Changed (user-facing / marketing copy):
- index.html <h1>: "Blink Pay Button Generator" -> "Blink Donation Button
  Generator"
- generator.js: embed-snippet comments the user copies + file header
- README / MULTILANG-README / ANALYTICS-README / USD-invoice guide headings
- *-test.html titles/headings + wordpress snippet comment
- package.json description

Deliberately NOT changed (code identity / API / legal, not marketing copy):
- window.BlinkPayButton API, blink-pay-button-container id, .blink-pay-*
  classes, js/blink-pay-button.js filename/header + console.error strings
- LICENSE copyright attribution
- referral=embedded_donation_button analytics value

No behavior change; npm test green (86 passing).
@pretyflaco
pretyflaco merged commit ab23734 into main Jul 20, 2026
2 checks passed
@pretyflaco
pretyflaco deleted the copy/donation-button-consistency branch July 20, 2026 21:34
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