Skip to content

docs(beta): add dedicated beta signup form, split from check-in#413

Merged
ibanner56 merged 1 commit into
mainfrom
isaacbanner-beta-signup-template
Jul 20, 2026
Merged

docs(beta): add dedicated beta signup form, split from check-in#413
ibanner56 merged 1 commit into
mainfrom
isaacbanner-beta-signup-template

Conversation

@ibanner56

Copy link
Copy Markdown
Owner

What & why

The landing page's beta button linked to the check-in form, which had no signup guidance — a first-time tester had no clear way to say "I want in." GitHub issue forms can't conditionally show/hide fields, so a single toggling form isn't possible; instead this splits the two intents into two clean forms.

Changes

  • New 🙋 Join the beta template (beta_signup.yml): platforms you'll test, Apple ID email for iOS/iPadOS TestFlight (only field actually needed, and only for iOS), calling background, areas of interest, beta-expectations + privacy acknowledgements. Labeled beta, status: triage.
  • Check-in template: intro now points first-timers to the signup form; scope is clearly "how a build held up once you're testing."
  • Landing page: the single "Sign up / send a check-in" button becomes two distinct actions — Join the beta (signup) and Send a check-in — with the "how it works" steps updated to match.

Notes

  • iOS TestFlight email is the only required-ish personal detail; the privacy acknowledgement is worded to allow it while excluding everything else.
  • Both YAML forms validated locally; no other docs referenced the old link.

Docs/config-only (issue templates + static site copy); no app code touched.

Adds a '🙋 Join the beta' issue template so prospective testers have an
explicit place to sign up (platforms, TestFlight email for iOS, calling
background) instead of overloading the periodic check-in form. Cross-links
the two forms and updates the landing page to offer 'Join the beta' and
'Send a check-in' as distinct actions.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 20, 2026 20:32

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves the beta onboarding/feedback flow by splitting “join the beta” (one-time signup) from “beta check-in” (ongoing feedback) and updating the landing page copy/CTAs to match, making it clearer for first-time testers how to get started.

Changes:

  • Added a new GitHub Issue Form template for beta signup (beta_signup.yml) with platform selection, optional TestFlight email, and required expectation/privacy acknowledgements.
  • Updated the existing beta check-in template to redirect first-time testers to the new signup form.
  • Updated the site landing page beta section to present separate CTAs for “Join the beta” vs “Send a check-in” and revised the “How it works” steps accordingly.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
site/index.html Splits the beta CTA into two actions (signup vs check-in) and updates beta explainer copy/steps.
.github/ISSUE_TEMPLATE/beta_signup.yml Introduces a dedicated one-time beta signup Issue Form with privacy/expectation acknowledgements.
.github/ISSUE_TEMPLATE/beta_check_in.yml Adds guidance directing new testers to the beta signup form before submitting check-ins.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@ibanner56
ibanner56 merged commit b591c41 into main Jul 20, 2026
8 checks passed
@ibanner56
ibanner56 deleted the isaacbanner-beta-signup-template branch July 20, 2026 20:47
ibanner56 added a commit that referenced this pull request Jul 22, 2026
* docs: reconcile public docs to v0.1.0-beta.3 + current status

Establish a single source of truth for the app version and per-platform
install/signing status (verified against app/pubspec.yaml, CHANGELOG, and
the beta.3 release.yml run), then make every public-facing doc consistent:

- Version: current release is v0.1.0-beta.3 (was beta.2 in the site pill).
- Signing (verified from the beta.3 release run logs): macOS signed +
  Developer ID + notarized/stapled; Android signed APK; Windows/Linux
  unsigned; iOS TestFlight-only (invite).

Fixes:
- beta-guide: replace the self-contradictory "installation not packaged /
  run a dev build" + "dialect library & .USR still in progress" bullets
  (all shipped) with an accurate per-platform signing note; point "How to
  join" and feedback sections at the now-live Join-the-beta and issue forms.
- site/index.html: version pill v0.1.0-beta.2 -> v0.1.0-beta.3 (fallback;
  app.js already self-aligns from beta.json).
- beta-recruitment: drop stale "installers still being packaged / dev build"
  claims from the templates and honesty note; builds ship for every platform.
- ROADMAP §7: GitHub Pages now enabled (manifests hosted + landing page #408);
  Discussions enabled; beta signup form #413 delivered; beta execution
  in progress; current release is beta.3 (was beta.1/beta.2).
- README: beta/feedback section — all issue forms are live now; add the
  Join-the-beta form and project landing-page links.

Docs only; no app code or configuration changes.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

* docs: address Copilot review on #453

- beta-guide: keep Apple ID / TestFlight emails out of the public signup
  issue — sign up via the form for platforms, send the invite address
  privately to isaac@banner.is instead.
- beta-guide: correct per-platform first-run steps — Android still needs a
  one-time "install unknown apps" sideload permission, Windows shows
  SmartScreen, Linux has no signing prompt (just the executable bit); matches
  docs/user/installation.md.
- ROADMAP §7.3: "builds ship for every platform" now retains the signing
  qualifiers so it no longer contradicts the §7.1 status (Win/Linux unsigned).
- CONTRIBUTING.md: the beta-specific forms are all live now (not "as the beta
  rolls out") and add the Join-the-beta signup.
- releasing.md: version-fallback bullet no longer embeds a specific beta
  version.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
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.

2 participants