Skip to content

4146 add troubleshooting section #4181

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 36 commits into
base: main
Choose a base branch
from

Conversation

dhtclk
Copy link
Collaborator

@dhtclk dhtclk commented Jul 28, 2025

Summary

Adding a troubleshooting page to create a space for useful links based on support data. Hopefully boosting discoverability of some existing quality docs and kb articles.

@dhtclk dhtclk requested a review from a team as a code owner July 28, 2025 20:56
@dhtclk dhtclk linked an issue Jul 28, 2025 that may be closed by this pull request
Copy link

vercel bot commented Jul 28, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Project Deployment Preview Comments Updated (UTC)
clickhouse-docs Ready Preview Comment Aug 12, 2025 11:16am
3 Skipped Deployments
Project Deployment Preview Comments Updated (UTC)
clickhouse-docs-jp ⬜️ Ignored Aug 12, 2025 11:16am
clickhouse-docs-ru ⬜️ Ignored Preview Aug 12, 2025 11:16am
clickhouse-docs-zh ⬜️ Ignored Preview Aug 12, 2025 11:16am

@Blargian
Copy link
Member

@dhtclk LGTM, just two small things to change:

Screenshot 2025-07-29 at 11 31 31

Could we make it just a single menu item rather than a dropdown? I think the expanding tab is only necessary if we have more than one page.

If we're adding here we should probably add it as an item in the top menu:

Screenshot 2025-07-29 at 11 32 37

Copy link
Member

@Blargian Blargian left a comment

Choose a reason for hiding this comment

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

Let's get this in soon, just a few small changes to make - see comments.

- [Session memory settings](/docs/operations/settings/settings)
<br/>
### Scaling and sizing: {#scaling-and-sizing}
- [Right-size your service](/docs/operations/tips)
Copy link
Member

Choose a reason for hiding this comment

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

Just an idea, but some of these like this one are only really applicable to OSS ClickHouse. Maybe we should mark them with a ⛁ vs ☁️ if they are specific

@dhtclk
Copy link
Collaborator Author

dhtclk commented Aug 6, 2025

@kellytoole I know you also said you wanted to take a look at this. There's a first draft of the "lessons learned" doc in this PR along with the troubleshooting section.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add Troubleshooting Section Identify common user pain points from meet up presentations
2 participants