experimental/ssh: improve --help copy for ssh commands

[TanishqDatabricks]

Summary

• Updates help text for databricks ssh, databricks ssh connect, and databricks ssh setup to reflect current workflows (serverless-first, dedicated clusters as follow-up)
• Unhides --name, --accelerator, --ide, and --environment-version flags on connect so users can discover them via --help
• Tightens setup description to clarify it's for dedicated clusters only

Test plan

• databricks ssh --help, databricks ssh connect --help, databricks ssh setup --help show updated copy

This pull request and its description were written by Isaac.

[ghost]

Waiting for approval

Based on git history, these people are best suited to review:

• @ilia-db -- recent work in experimental/ssh/cmd/

Eligible reviewers: @andrewnester, @anton-107, @denik, @pietern, @renaudhartert-db, @shreyas-goenka, @simonfaltum

_{Suggestions based on git history. See OWNERS for ownership rules.}

[anton-107]

Thanks for cleaning up the help copy — direction is right. A few changes before merging:

1. Keep --environment-version hidden

This flag still isn't ready for users to discover via --help. Please restore cmd.Flags().MarkHidden("environment-version") in experimental/ssh/cmd/connect.go.

Unhiding --name, --accelerator, and --ide is fine.

2. Misaligned # comments in ssh.go workflow block

The first example uses two tabs before #, the other two use spaces. Actual rendered output of databricks ssh --help:

  databricks ssh connect --ide=cursor                       		# connect to serverless through Cursor
  databricks ssh setup --name=<connection> --cluster=<cluster-id>   # update ~/.ssh/config so you can reconnect to a dedicated cluster
  ssh <connection>                                                  # connect to dedicated cluster after setup

The first # lands ~4 columns to the right of the other two (tab expands to the next 8-column tabstop). Replace the tabs with spaces so all three # align.

Same nit in connect.go: databricks ssh connect --accelerator=<GPU_type>\t# AI Runtime uses a tab. Renders fine in isolation but is inconsistent — spaces would be cleaner.

3. Inconsistent placeholder: <name> vs <connection>

• ssh setup --help: `ssh <name>`
• ssh --help workflow: ssh <connection> and --name=<connection>

Pick one. <name> matches the flag name; <connection> reads as a concept but loses the link. Either is fine — just be consistent across both files.

Test plan

The PR's test plan checkbox is unchecked. Please run all three --help outputs and eyeball them before re-requesting review — that's what caught issue #2 here.

[ghost]

An authorized user can trigger integration tests manually by following the instructions below:

Trigger:
go/deco-tests-run/cli

Inputs:

• PR number: 5325
• Commit SHA: d7da1cc9fbfc8de630e651bdf30df2c51d3f38dd

Checks will be approved automatically on success.