Use terminology "Notebook runtime" instead of "Cluster", except when it is actually a cluster
Most of the time in Terra when you are editing notebooks your notebook runtime consists of a single VM. The interface, however, at times says "cluster" which can be both confusing and intimidating to users. While the default is a single instance and the interface does show the cost, it can feel like over-provisioning and more expensive than necessary to create a "cluster". We should indicate "cluster" only in places where you've truly created a cluster.
A few places I have observed this:
- Viewing a notebook read-only when I don't yet have a runtime, I get a button "create a cluster to edit"
- Hovering over the trashcan icon, it says: "Delete cluster"
I filed this as a "Feature Request" rather than a github issue as I'd like to suggest it applies across the UI and documentation. As FireCloud documentation is migrated into Terra documentation, this would be something to look out for.
Thanks!
Comments
3 comments
One more instance:
- I had a notebook opened and my machine went to sleep
- When I cam back, the notebook runtime had stopped
- In the Jupyter UI when I tried to restart the kernel, a message popped up to the effect of:
"Cluster fc... is stopped. Start your cluster before proceeding."
https://github.com/DataBiosphere/leonardo/blob/5aa3e2b6de17522d9e8b4dc16a1c833948d29c38/automation/src/test/scala/org/broadinstitute/dsde/workbench/leonardo/LeonardoTestUtils.scala
I agree, this is a good idea. Lately I'm trying to use "notebook runtime" terminology more.
Note that the terminology, as of September 17, 2020, is "Cloud Environment":
https://support.terra.bio/hc/en-us/articles/360049850711-September-17-2020
Please sign in to leave a comment.