-
Notifications
You must be signed in to change notification settings - Fork 15
Open
Labels
docs-agentdocumentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomers
Description
Context
Slack thread: https://slack.com/archives/C0AE8A81LE6/p1770829426570839
The thread shows team members updating channel topic metadata with key contacts/agents, which suggests operational contact points are being managed in Slack rather than easily found from docs.
Problem
Current documentation does not make support/escalation entry points easy to discover. Users and operators may not know where to find:
- who to contact for incident reproduction/debug support
- where support workflow starts (Cloud vs self-hosted)
- which docs page to check first for troubleshooting vs FAQ
This creates friction and pushes critical routing info into Slack-only tribal knowledge.
Suggested Fix
- Add a short, searchable "Get Help / Escalation" section to high-traffic entry pages (for example intro/FAQ/troubleshooting entry points).
- Include clear keywords users are likely to search:
support,escalation,incident,reproduce,troubleshooting,who to contact. - Add cross-links between Cloud intro/FAQ and troubleshooting pages so users can navigate quickly to the correct path.
- Add one concise decision flow: "I have an outage", "I need product usage help", "I found a potential bug".
- Ensure page titles and headings include support-oriented terms to improve site search results.
Existing Documentation
- README.md
- cloud/faq.mdx
- cloud/sso.mdx
- cloud/intro.mdx
- sql/functions/mathematical.mdx
- operate/telemetry.mdx
- troubleshoot/meta-failure.mdx
- sql/commands/sql-alter-fragment.mdx
- ingestion/sources/postgresql/neon.mdx
- operate/secure-connections-with-ssl-tls.mdx
Related docs PRs:
Codebase References
Related PRs in risingwave:
- feat: risectl command to force change Source Connector Props
- feat: support LogicalExpand in DataFusion
- refactor: update some metric level
- fix(snapshot-backfill): fix deadlock caused by next_epoch
- feat(sink): support copy into wihout barrier for redshift
Source files:
Reactions are currently unavailable
Metadata
Metadata
Labels
docs-agentdocumentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomers