Skip to content

docs(workbench): rewrite welcome.md to match #161 reality (one click, not auto-open)#162

Open
fede-kamel wants to merge 1 commit into
mainfrom
docs/workbench-honest-welcome
Open

docs(workbench): rewrite welcome.md to match #161 reality (one click, not auto-open)#162
fede-kamel wants to merge 1 commit into
mainfrom
docs/workbench-honest-welcome

Conversation

@fede-kamel
Copy link
Copy Markdown
Contributor

Summary

After PR #161 moved the tier startup into postAttachCommand and deleted postStart.sh, welcome.md was left referencing the old setup ('Three tiers are auto-started by postStart.sh') — which now points to a deleted file. Plus the welcome was promising 'a separate browser tab is opening' which doesn't reliably happen.

Honest welcome.md

Now reads:

  • Three ways to open the workbench UI with one click (URL in terminal, Ports panel, Cmd-Shift-P)
  • Brief explanation that auto-open was attempted (openPreview + code --open-url) but Codespaces VS Code Web doesn't reliably honor either from shell context
  • Correct file references (workbench-attach.sh, not postStart.sh)
  • Updated restart command

Why no auto-open

Five PRs tried (#155, #157, #158, #160, #161). Each fixed a real bug along the way (deps, lifecycle ordering, URI format) but the final mile — programmatically opening Simple Browser from a shell script in postAttachCommand — doesn't have a reliable mechanism in current Codespaces VS Code Web. The platform doesn't expose a guaranteed-to-fire path from shell. Document it honestly rather than pretending.

Related

… not auto-open)

Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label May 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant