Skip to content

Follow along with our tutorials to get you up and running with the Snowflake Data Cloud.

License

Notifications You must be signed in to change notification settings

sfc-gh-swinkler/sfquickstarts

 
 

Repository files navigation

Snowflake Quickstarts

Demo

What are Snowflake Quickstarts?

Snowflake Quickstarts are interactive tutorials and self-serve demos written in markdown syntax. Quickstarts provide a unique step-by-step reading experience and automatically saves tutorial progress for readers. These tutorials are published at quickstarts.snowflake.com

You can submit your own Quickstarts to be published on Snowflake's website by submitting a pull request to this repo. This repository contains all the tools and documentation you’ll need for building, writing, and submitting your own Quickstart!

What's special about the Quickstart format?

  • Powerful and flexible authoring flow in Markdown text
  • Ability to produce interactive web or markdown tutorials without writing any code
  • Easy interactive previewing
  • Usage monitoring via Google Analytics
  • Support for multiple target environments or events (conferences, kiosk, web, offline, etc.)
  • Support for anonymous use - ideal for public computers at developer events
  • Looks great, with a responsive web implementation
  • Remembers where the student left off when returning to a quickstarts
  • Mobile friendly user experience

Getting Started

Prerequisites

  1. Install Node 14; Homebrew installed? brew install node@14
    • Install gulp-cli npm i -g gulp-cli
  2. Install Go; Homebrew installed? brew install golang
    • Install claat go install github.com/googlecodelabs/tools/claat@latest
    • Ensure go and claat is in your PATH claat path setup
  3. Optional: install the live-reload plugin for Chrome: LiveReload

Run locally

  1. Fork this repository to your personal github account (top right of webpage, fork button)
  2. Clone your new fork git clone [email protected]:<YOUR-USERNAME>/sfquickstarts.git sfquickstarts
  3. Navigate to the site directory cd sfquickstarts/site
  4. Install node dependencies npm install
  5. Run the site npm run serve

Congratulations! You now have the Snowflake Quickstarts landing page running.

Common Errors

1. Claat related errors

  • Make sure Go is properly in your PATH. Add the following lines to your profile (~/.profile, or ~/.zshrc):
#adding Golang to path
export PATH=$PATH:/usr/local/go/bin
export PATH=$PATH:$HOME/go/bin

Note: After adding Go to your PATH, be sure to apply your new profile: source ~/.profile or source ~/.zshrc

2. You get a EACCES error when installing gulp-cli

3. You get Error: Cannot find module 'postcss' when running npm run serve

  • The module may not have been installed for some reason so run npm install --save-dev postcss gulp-postcss and then rerun npm run serve

Write Your First Quickstart

  1. Terminate the running server with ctrl C and and navigate to the sfguides source directory cd sfguides/src
    • In this directory, you will see all existing guides and their markdown files.
  2. Generate a new guide from the guide template npm run template <GUIDE_NAME>
    • Don't use spaces in the name of your guide, instead use underscores.
  3. Navigate to the newly generated guide (cd sfguides/src/<GUIDE_NAME>) and edit your guide in a tool like vscode.
  4. Run the website again npm run serve
  5. As you edit and save changes, your changes will automatically load in the browser.

You can always read the sample Quickstart online.

Tips

How do I get my Snowflake Quickstart on quickstarts.snowflake.com?

  1. You will need to sign Snowflake's CLA
  2. Fork this repository
  3. Clone it to your local system
  4. Make a new branch
  5. Make your changes
  6. Push it back to your repo
  7. Open this repository on GitHub.com
  8. Click the Pull Request button to open a new pull request
  9. Snowflake will review and approve the submission

To learn more how to submit a pull request on GitHub in general, checkout github's official documentation.

About

Follow along with our tutorials to get you up and running with the Snowflake Data Cloud.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 34.9%
  • Go 26.6%
  • JavaScript 21.5%
  • SCSS 9.9%
  • PLpgSQL 2.8%
  • Starlark 2.6%
  • Other 1.7%