Multiple issues with the Zero to Snowflake quickstart guide

[MPagel]

Describe the bug Nothing is where it says it is. Your UI team needs to work more closely with your technical writers to sync version-appropriate documentation

URL of where you see the bug https://quickstarts.snowflake.com/guide/getting_started_with_snowflake/index.html?index=..%2F..index#3

• "Ensure you are using the sysadmin role by selecting your name at the top left, Switch Role > SYSADMIN."

The user name is at bottom-left, not top-left or the conventional top-right. Plus, "ensure" implies that SYSADMIN is the default role, or is in most cases is already selected. This was not the case. See also #1035

• "Navigate to the Databases tab. Click Create, name the database CITIBIKE, then click CREATE."

There is not a create button at the indicated location. At top right is a "+ Database" button that accomplishes this

• "Now navigate to the Worksheets tab. You should see the worksheet we created in step 3."

The Worksheets sub-"tab" is only visible when the "Projects" tab is selected. We were just doing something in the databases tab, not projects, so worksheets was not visible.

As to the "worksheet we created in step 3", assuming you mean in the Zero to snowflake guide, the navigation tab titled "3: The Snowflake User Interface & Lab story" rather than any of the unnumbered steps within "4: Preparing to Load Data", it tells you that you can create a worksheet, but doesn't instruct you to do so, instead it says:

• "A new worksheet is created by clicking + Worksheet on the top right."

The tense of the phrase coupled with the rest of that tab being informational, rather than actionable, suggests that that line was not an affirmative instruction. Notwithstanding such grammatical issues, step 3 does not tell you whether you should select "SQL Worksheet" "Python Worksheet" or "Folder" after clicking the + Worksheet button. I'm assuming the first two are functional equivalents, but for the sake of the tutorial you should really spell out what the user should click, as I'm sure "folder" does NOT do what you need.

• "To make working in the worksheet easier, let's rename it. In the top left corner, double-click the worksheet name, which is the timestamp when the worksheet was created, and change it to CITIBIKE_ZERO_TO_SNOWFLAKE."

Double clicking the name does not bring up a rename dialog box (nor does single-click or right click). you have to hover over the timestamp-name and hit the "..." button that only shows in the bar during hover-over, and then select "Rename".

• "Next we create a table called TRIPS to use for loading the comma-delimited data. Instead of using the UI, we use the worksheet to run the DDL that creates the table. Copy the following SQL text into your worksheet:"

For some reason (browser: firefox; OS: Windows 11) I could not initially edit the SQL in the window. Even when I did get it to respond, regardless of where I clicked, it automatically put the cursor at the left side of the query text. Pasting replaces what was already there, rather than prepending it. This was unexpected.

• "...click CITIBIKE > PUBLIC > TABLES to see your newly created TRIPS table. If you don't see any databases on the left, expand your browser because they may be hidden.
• Click TRIPS and the Columns tab to see the table structure you just created."

Clicking, double-clicking or right clicking "TRIPS" doesn't bring up a window with a "columns" tab nor a context menu that has the appropriate info. To get that, you need to hover over trips, then in the bubble that opens, click on the "open table details in new tab" icon. THEN you can see a columns tab.

This is as far as I got in the guide, because at least to this point, it has been almost 100% inaccurate. Please fix. If you'd rather have a version-agnostic guide, it should instead be written in a more generic fashion and it should be more clear so that the user knows that figuring out how to use the interface is up to them and is not covered by the guide. Having instructions that are specific, but incorrect, is extremely frustrating.

Horrible user experience so far.

[iamontheinet]

Hi @MPagel! Sorry for the delayed response. We're in the process of revamping this QS. Please stay tuned and thank you for your patience.