Skip to content

docs: soften email requirement messaging - #20

Merged
aboutte merged 1 commit into
devfrom
docs/relax-email-messaging
Sep 30, 2026
Merged

aboutte merged 1 commit into
devfrom
docs/relax-email-messaging

Conversation

@aboutte

@aboutte aboutte commented Sep 30, 2026

Copy link
Copy Markdown
Collaborator

Why

The license server has been relaxed. It now sorts addresses into three buckets:

  • consumer (gmail, icloud, yahoo, …) — now allowed
  • privacy (proton, relay domains) — rejected
  • known spam / disposable — rejected

So both true business and consumer addresses are accepted. The devkit messaging still told users "use your work address — personal domains are not accepted", which is now wrong and turns people away for no reason.

What changed

run.sh

  • The EMAIL response-code comment: "personal domain" → "privacy-relay or disposable domain".
  • Non-interactive and give-up errors now read Re-run with --email <addr> — most work and personal addresses are accepted; privacy-relay and disposable domains are not.
  • The post-rejection retry prompt is now Email address: instead of Work email:.

The first prompt (Admin email:) was never domain-flavored and is unchanged. The server's own rejection message is still echoed verbatim before any devkit hint, so users always see the real reason.

Docs — same softening in README.md, docs/quickstart.md, docs/configuration.md, docs/faq.md, docs/cli-reference.md, docs/troubleshooting.md, docs/getting-started/install.md (incl. "verified business email address" → "verified email address — work or personal"), docs/getting-started/prerequisites.md, and hackday/Installing DevKit.md.

Verification

  • bash -n run.sh passes.
  • No work email / work address / personal domain / business email wording remains anywhere in the repo.
  • tests/ holds only provider/wiring shell tests (gateway, subscription, Bedrock) that stand up containers and are unrelated to this copy change — not run.

Note for reviewers

I described the rejected set as privacy-relay and disposable domains. The third server-side category was given to me as "known spam" — if the server's actual rejection text uses different words, the follow-on hint may drift slightly from what users see on screen. Worth a glance from whoever owns the license server copy.

🤖 Generated with Claude Code

The license server now accepts consumer domains (gmail, icloud, yahoo)
alongside business addresses. Only privacy-relay and known-spam/disposable
domains are rejected, so the "work address only / personal domains are not
accepted" wording is no longer accurate.

- run.sh: retry prompt is now `Email address:` instead of `Work email:`,
  and the non-interactive/give-up errors describe the real rule
- README, quickstart, install, prerequisites, configuration, faq,
  cli-reference, troubleshooting, hackday guide: same softening

The server's own rejection message is still echoed verbatim first; the
devkit wording is only the follow-on hint.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@aboutte
aboutte requested a review from gk-duplo as a code owner September 30, 2026 12:48
@aboutte
aboutte merged commit 5ce600c into dev Sep 30, 2026
1 check passed
@aboutte
aboutte deleted the docs/relax-email-messaging branch September 30, 2026 12:51
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