DOC-339: Rewrite Snowflake Getting Started to mirror AWS v2 and default to lstk - #878
Draft
quetzalliwrites wants to merge 1 commit into
Draft
Conversation
…lt to lstk Mirrors the AWS Getting Started rewrite (DOC-12) information architecture: Overview, Installation, Local Development, CI Integration, AI & Agent Workflows, Auth Token, FAQ. - Overview and Installation are split into separate pages; Overview is a new SectionCards landing page, Installation leads with lstk (lstk start --type snowflake), with Docker Compose/CLI as secondary paths. - Quickstart is decoupled and removed; its content is folded into a new Local Development page with an explicit, unbroken walkthrough: start the emulator via lstk, connect the Snowflake CLI to a `localstack` connection profile, run a first query, inspect results in the Web App, then clean up. Adds a redirect from the old quickstart URL. - CI Integration is a new page with lstk-based CI snippets, and AI & Agent Workflows is a new top-level page centered on the MCP server's localstack-snowflake-client tool. - Auth Token and FAQ are restructured to match the AWS pattern while keeping Snowflake-specific content (session verify endpoint, SQL API/hostname/image-tag FAQs) that has no AWS equivalent. - Fixed three tutorial pages whose prerequisite links pointed at the now-split /snowflake/getting-started/ page. Deviates from a literal AWS mirror where the underlying product differs: no lstk wrapper for the Snowflake CLI (agents run `snow` directly against its own connection profile), no per-provider CI guide fan-out (links to the existing consolidated CI integration page instead), and no claim about Snowflake-specific LocalStack Skills coverage since it could not be verified.
quetzalliwrites
requested review from
HarshCasper and
remotesynth
as code owners
August 20, 2026 11:33
Deploying localstack-docs with
|
| Latest commit: |
fe933b3
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://b741887b.localstack-docs.pages.dev |
| Branch Preview URL: | https://doc-339-docs-snowflake-getti.localstack-docs.pages.dev |
quetzalliwrites
marked this pull request as draft
August 20, 2026 11:35
Collaborator
Author
|
Moving this to draft mode, still want to test and refine it further before going to review round. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Mirrors the AWS Getting Started rewrite (DOC-12, #606) information architecture for Snowflake: Overview, Installation, Local Development, CI Integration, AI & Agent Workflows, Auth Token, FAQ.
lstk(lstk start --type snowflake), with Docker Compose/CLI as secondary paths.lstk→ connect the Snowflake CLI to alocalstackconnection profile → run a first query → inspect results in the Web App → clean up. Adds a 301 redirect from the old quickstart URL.lstk-based CI snippets.localstack-snowflake-clienttool./snowflake/getting-started/page.Where this deliberately doesn't mirror AWS 1:1
lstkwrapper for the Snowflake CLI. Agents/users runsnowdirectly against its ownlocalstackconnection profile — there's nolstk snowproxy the way there'slstk aws/lstk terraform/lstk cdk./aws/ci-pipelines/<provider>/pages; Snowflake only has one consolidated CI page, so CI Integration links there instead of inventing pages that don't exist.LocalStack/setup-localstack@mainGitHub Action example for the CI snippets, since its Snowflake support is unverified; used a plainlstk-based step instead.Linear: https://linear.app/localstack/issue/DOC-339/docs-snowflake-getting-started-v2-also-making-lstk-default-cli
Test plan
astro buildcompletes successfully (403 pages)starlight-links-validatorreports all internal links validlstk