Skip to content

docs: simplify the support page messenger section - #38083

Draft
claude[bot] wants to merge 3 commits into
mainfrom
docs/support-page-messenger-cleanup
Draft

docs: simplify the support page messenger section#38083
claude[bot] wants to merge 3 commits into
mainfrom
docs/support-page-messenger-cleanup

Conversation

@claude

@claude claude Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Requested by Pranshu Maheshwari · Slack thread

Motivation

Cleanups to https://materialize.com/docs/support/ and to the support row of the self-managed editions table, requested in the Slack thread linked above.

  1. The "Messenger App" subheading is redundant. The page already has a "Materialize Support" heading immediately above it, so the reader gets two headings back to back before any content.
  2. The note announcing that Slack and Microsoft Teams support workspaces are being retired has served its purpose and no longer needs to sit at the top of the page.
  3. With the "Messenger App" heading gone, the self-managed editions comparison table still pointed readers at a "messenger app" by name. Katrina Van Meer, who owns the support-messaging surface, confirmed that the messenger app is Matty, the AI support agent, and that users should still be directed to open tickets through it. Naming Matty directly is clearer than naming a generic app.

Description

The first two changes are in doc/user/content/support.md. No prose, bullets, or callouts were reworded.

Removing the "Messenger App" heading

Before:

Materialize Support

We offer multiple support pathways depending on your platform and plan:

Messenger App

You can reach us directly from: ...

After:

Materialize Support

We offer multiple support pathways depending on your platform and plan:
You can reach us directly from: ...

The ### Messenger App heading line is deleted rather than renamed. Renaming it to "Materialize Support" would have produced a duplicate of the ## Materialize Support heading directly above it. Deleting it makes the messenger content the lead-in for the "Materialize Support" section, with ### Email and ### Join the Materialize Slack community remaining as sibling subsections. The bullets, the Matty paragraph, and the TIP callout about "Report Production Outage" are all untouched.

Deleting the heading also removes the #messenger-app anchor. The "Urgent Issues" section further down linked to it, so that link is repointed to #materialize-support, which is the section the messenger content now lives in. That was the only reference to #messenger-app anywhere in the repo.

Removing the retirement note

The following {{< note >}} block is deleted in full:

We're retiring access to Slack and Microsoft Teams workspaces. We've introduced the messenger app to streamline and scale how users engage with support — starting with AI-first assistance and seamless escalation paths when needed.

It sat between the page's opening line and the "Materialize Support" heading, so removing it leaves no orphaned prose or empty section. The intro line "Whether you're building, scaling, or debugging, we're here to help." now runs straight into the "Materialize Support" heading.

Note that this only removes the retirement announcement. The separate "Join the Materialize Slack community" subsection, which points at the community Slack, is a different thing and is left in place.

Naming Matty in the self-managed editions table

The self-managed editions comparison table renders on the docs home page (/) and on /get-started/. Its Support row described Community Edition support as "Community slack or messenger app". The link text is now "Community Slack or Matty". The link target stays /support/, so readers still land on the support page to open a ticket, and the lowercase "slack" is capitalized on the way past.

Before:

| Support | ... | Community slack or messenger app |

After:

| Support | ... | Community Slack or Matty |

The change is applied in two places:

  • doc/user/data/self_managed/self_managed_editions_table.yml, the data file that actually drives the rendered table.
  • doc/user/layouts/shortcodes/self-managed/self-managed-editions-table.html, an unreferenced near-duplicate of the same table. Nothing renders it today, so it is left in place rather than deleted, but it is updated in step so the two copies do not drift.

Verification

Built the docs site locally with the pinned toolchain, Hugo extended v0.152.2, from doc/user. The build completes with no shortcode or template errors (598 pages, 427 aliases).

Checked the rendered support/index.html to confirm:

  • No Messenger App heading is emitted, and no messenger-app string remains on the page.
  • The retirement note is gone (no retiring string on the page).
  • Every in-page href=#... on the support page resolves to a heading id that exists in the rendered output, including the repointed href=#materialize-support.

Checked the rendered index.html and get-started/index.html to confirm:

  • Both render <a href="/support/" >Community Slack or Matty</a> in the Support row of the editions table.
  • Neither page contains the string messenger anywhere any more.

The Hugo output directory doc/user/public is gitignored and is not part of this branch.


Generated by Claude Code

Drop the "Messenger App" subheading so the messenger prose reads directly
under the "Materialize Support" heading, and remove the note announcing
the retirement of the Slack and Microsoft Teams support workspaces.

Repoint the in-page "messenger's" link from the now-removed
`#messenger-app` anchor to `#materialize-support`.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016XfigUauXbf1SnKCHjfyhV
Comment thread doc/user/content/support.md Outdated

## Materialize Support

We offer multiple support pathways depending on your platform and plan:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Remove this line

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Removed in 7967277.


Generated by Claude Code

claude added 2 commits August 6, 2026 14:30
Address review feedback on the support page.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016XfigUauXbf1SnKCHjfyhV
The self-managed editions comparison table, rendered on the docs home
page and the get-started page, described Community Edition support as
"Community slack or messenger app". "Messenger app" is the AI support
agent, Matty, so name it directly. Also capitalize Slack.

The change is applied to both the data file that drives the rendered
table and the unreferenced near-duplicate shortcode, so the two copies
do not drift.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016XfigUauXbf1SnKCHjfyhV
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.

2 participants