Skip to content

docs: launch v2 Help & Support experience for snow docs#435

Merged
quetzalliwrites merged 18 commits intomainfrom
docs-snow-help-support-improved-devex
Mar 27, 2026
Merged

docs: launch v2 Help & Support experience for snow docs#435
quetzalliwrites merged 18 commits intomainfrom
docs-snow-help-support-improved-devex

Conversation

@quetzalliwrites
Copy link
Collaborator

Improve Snowflake's Support & Help visibility via DOC-16

@quetzalliwrites quetzalliwrites self-assigned this Feb 13, 2026
@quetzalliwrites quetzalliwrites added documentation Improvements or additions to documentation snow labels Feb 13, 2026
@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Feb 13, 2026

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: af90e5f
Status: ✅  Deploy successful!
Preview URL: https://bd659997.localstack-docs.pages.dev
Branch Preview URL: https://docs-snow-help-support-impro.localstack-docs.pages.dev

View logs

@quetzalliwrites
Copy link
Collaborator Author

quetzalliwrites commented Feb 13, 2026

@remotesynth facing a tiny bug issue, I come seeking thine wisdom 😸

I put up the new Snow Help & Support PR and the first commit built this:
https://3745df0b.localstack-docs.pages.dev/snowflake/help-support/help-support/

You can see the new Help & Support nav element is rendered correctly in the left hand nav.

But as you can see in the screenshot attached, I realized I should have named the entry file index.md vs repeating help-support.md which is also the directory name.

Screenshot 2026-02-13 at 7 45 41 PM

So then I made that commit update here, but now the Help & Support nav element is gone from the nav, as you can see in latest build url: https://c07b13a5.localstack-docs.pages.dev/

Screenshot 2026-02-13 at 7 51 01 PM

@komarkovich
Copy link
Contributor

Provided my review here

Copy link

@mmaureenliu mmaureenliu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like the comprehensive contents of this new guide, but would like to see some re-structuring. As Przemek commented, the purpose of this guide is to make it easy for users to report a bug or to seek support. All they want to know is how to submit a ticket, but it's still too much reading before they can locate that piece of information. I would suggest some restructuring, e.g.

Start with the briefest overview of localstack support and go straight to "how to raise a support issue". Theses should fit in one screen view without scrolling. Since we don't do open source, the support email and webapp access are universal to all snowflake users.

Still within the same screen, after giving the support channels, we can mention that their subscription may entitle them to VIP support resources (well you'll have better wording than this) so the curious can read on about our support plans. Within each plan, we'll then only need to mention the scope and what additional benefits (beyond the two channels to raise an issue we mentioned above) they have access to.

@quetzalliwrites
Copy link
Collaborator Author

Great thoughts and feedback @mmaureenliu, ty.

Split monolithic support doc into 5 focused pages:
- Overview
- Support Plans
- Get Help
- Report an Issue
- Enterprise Support

Improves findability, reduces cognitive load, and aligns content with user support workflows.
@quetzalliwrites
Copy link
Collaborator Author

Hola @mmaureenliu, I did a thorough review of the feedback, and I realized that addressing each comment at the line level wouldn’t fully resolve the issues. The main problem was structural: the draft needed an information architecture overhaul rather than incremental edits.

As I explained before, I initially misunderstood your ticket to request having it all in a single TOC as Marko's notion doc outlined... my mistake naturally led to my draft becoming a monolithic, hard-to-navigate page. 😸 That’s what we were seeing in draft 1.

In draft 2, I took a step back and reorganized the content into smaller, task-oriented pages based on how users actually approach support (plans, getting help, reporting issues, etc.). This improves findability and reduces cognitive load.

Also, since we discussed that you’ll be OOO for the next two weeks, I prioritized moving this forward, so instead of replying to each individual comment in the PR, I focused on implementing a complete revision and included a detailed explanation of the new structure there.

Happy to walk through it together when you’re back if you want me to! 🙂

@quetzalliwrites
Copy link
Collaborator Author

This PR previously combined multiple distinct support concepts into a single doc (plans, channels, troubleshooting, reporting, enterprise workflows), which made it difficult for users to quickly find what they needed.

I’ve restructured this into 5 focused pages:

  • Overview
  • Support Plans
  • Get Help
  • Report an Issue
  • Enterprise Support

This change is intentional and based on how users actually approach support:

  • “What support do I have?” → Support Plans
  • “Where should I go for help?” → Get Help
  • “How do I submit an issue?” → Report an Issue
  • “What do I get as an enterprise customer?” → Enterprise Support

Each page now maps to a specific user task, which improves findability, reduces cognitive load, and avoids duplication across sections.

This also aligns the docs with a more product-oriented support experience, rather than a single aggregated reference page.

Copy link

@mmaureenliu mmaureenliu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This new structure looks good and is much easier to navigate - thank you!

I've left a few comments and would like them to be addressed before merge (esp. the ones related to the deprecated github issues) but will pre-approve so you won't be blocked by my unavailability once it's done.

@quetzalliwrites quetzalliwrites merged commit 09a2e29 into main Mar 27, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation snow

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants