Summary
The Welcome screen currently opens when a user logs into a session, which is too late to
serve as an onboarding guide for new users. Showing it at extension install or activation
time — and expanding its content to cover how to get connected to GemStone — would make
it genuinely useful as a "getting started" resource.
Acceptance criteria
- The Welcome screen opens the first time the extension is activated (install or VS Code
startup after install), not on session login.
- The Welcome content includes enough getting-started material for a brand-new user to
understand how to download GemStone and establish their first session.
- The existing "Getting Started…" mortar-board entry and command palette option continue
to work so users can reopen it on demand.
- The "show only once per machine" behaviour is preserved.
Implementation notes
One approach could be to move the trigger from the session-login path to the extension
activate() entry point, gating on the same "seen on this machine" flag already used for
the once-per-machine logic. The Welcome content itself would need a new section — possibly
a step-by-step guide covering GemStone download, stone setup, and first connection.
Migrated from GitLab: GemStone/grail#49
Summary
The Welcome screen currently opens when a user logs into a session, which is too late to
serve as an onboarding guide for new users. Showing it at extension install or activation
time — and expanding its content to cover how to get connected to GemStone — would make
it genuinely useful as a "getting started" resource.
Acceptance criteria
startup after install), not on session login.
understand how to download GemStone and establish their first session.
to work so users can reopen it on demand.
Implementation notes
One approach could be to move the trigger from the session-login path to the extension
activate()entry point, gating on the same "seen on this machine" flag already used forthe once-per-machine logic. The Welcome content itself would need a new section — possibly
a step-by-step guide covering GemStone download, stone setup, and first connection.
Migrated from GitLab: GemStone/grail#49