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!
- 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
- Install Node Version Manager (nvm)
- Not sure if you have it installed? Run
nvm
ornvm -v
at the command line and hit enter. If you encounter a "command not found" error, you likely do not have it installed.
- Not sure if you have it installed? Run
- Install Node v14 (required to run the site locally) using nvm:
nvm install 14
- If you have Homebrew installed, run:
brew install node@14
- If you have Homebrew installed, run:
- Install gulp-cli
npm i -g gulp-cli
- Install Go
- If you have Homebrew installed, run:
brew install golang
- Install claat
go install github.com/googlecodelabs/tools/claat@latest
- Ensure go and claat is in your
PATH
claat path setup
- If you have Homebrew installed, run:
- Optional: install the live-reload plugin for Chrome: LiveReload
- Fork this repository to your personal GitHub account (top right of webpage,
fork
button) - Clone your new fork
git clone [email protected]:<YOUR-USERNAME>/sfquickstarts.git sfquickstarts
- Navigate to the site directory
cd sfquickstarts/site
- Set the project to use Node v14 by running
nvm use
. If you an encounter an error stating you don't have the correct version installed, runnvm install
. For more help, see steps 1 and 2 in the Prerequisites above. - Install node dependencies
npm install
- Run the site
npm run serve
- Open a browser to http://localhost:8000/
Congratulations! You now have the Snowflake Quickstarts landing page running.
- 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
- This means that your npm location needs to be updated. Follow the steps here: Resolve EACCESS permissions
- The module may not have been installed for some reason so run
npm install --save-dev postcss gulp-postcss
and then rerunnpm run serve
- Terminate the running server with
ctrl C
and navigate to thesfguides
source directorycd sfguides/src
- In this directory, you will see all existing guides and their markdown files.
- 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 hyphens.
- Navigate to the newly generated guide (
cd sfguides/src/<GUIDE-NAME>
) and edit your guide in a tool like VS Code. - Run the website again
npm run serve
- As you edit and save changes, your changes will automatically load in the browser.
You can always read the sample Quickstart online.
- Review the sample.md file to learn more about how to structure your Quickstart for the claat tool.
- You can see the supported Quickstart categories here. If you want to suggest a new category please create a GitHub issue!
- Checkout how to use VS Code to write markdown files
- If you want to learn more about Quickstarts, check out this excellent tutorial
How do I get my Snowflake Quickstart on quickstarts.snowflake.com?
- You will need to sign Snowflake's CLA
- Fork this repository
- Clone it to your local system
- Make a new branch
- Make your changes
- Push it back to your repo
- Open this repository on GitHub.com
- Click the Pull Request button to open a new pull request
- Snowflake will review and approve the submission
To learn more about how to submit a pull request on GitHub in general, check out GitHub's official documentation.
Quickstarts are not in the scope of Snowflake Global Support. Please do not file support cases for issues or errata in a Quickstart. If you encounter an issue in a Quickstart (outdated copy or data, typos, broken links, etc.), please file an issue in this repository. Be sure to include the following information:
- The title of the Quickstart
- A link to the Quickstart
- A description of the problem
- A proposed solution, if applicable (optional)