Skip to content

docs: add single workspace limitation to Slack documentation#2287

Merged
amikofalvy merged 3 commits intomainfrom
docs-writer-ai-update-2026-02-24T06-30-57-660Z
Feb 24, 2026
Merged

docs: add single workspace limitation to Slack documentation#2287
amikofalvy merged 3 commits intomainfrom
docs-writer-ai-update-2026-02-24T06-30-57-660Z

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep Bot commented Feb 24, 2026

Summary

Updates the Slack integration documentation to reflect the single workspace per tenant limitation introduced in #2286.

Changes

Added a Note component to each of the three Slack documentation pages clarifying that:

  • Only one Slack workspace can be connected per Inkeep tenant
  • Re-authorizing the same workspace (for token refresh) is supported
  • To switch workspaces, the existing one must be uninstalled first

Files updated

  • agents-docs/content/talk-to-your-agents/slack/overview.mdx - Added limitation note after the Enterprise availability note
  • agents-docs/content/talk-to-your-agents/slack/installation.mdx - Added limitation note with details on re-auth vs. new workspace behavior
  • agents-docs/content/talk-to-your-agents/slack/configuration.mdx - Added limitation note with link to installation page for switching workspaces

Related

@inkeep inkeep Bot requested a review from amikofalvy February 24, 2026 06:33
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 24, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agents-api Ready Ready Preview, Comment Feb 24, 2026 6:37am
agents-docs Ready Ready Preview, Comment Feb 24, 2026 6:37am
agents-manage-ui Ready Ready Preview, Comment Feb 24, 2026 6:37am

Request Review

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Feb 24, 2026

⚠️ No Changeset found

Latest commit: 1520385

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@itoqa
Copy link
Copy Markdown

itoqa Bot commented Feb 24, 2026

Ito Test Report ✅

17 test cases ran. 17 passed.

This verification confirms that PR #2287 correctly adds the single workspace limitation Note to all three Slack documentation pages (Overview, Installation, Configuration). The Note components render properly with correct text variations per page, maintain proper spacing when consecutive, and the internal link in the Configuration page successfully navigates to the Installation page. The Commands/Usage Guide page remains unaffected as expected. All responsive layout, navigation, and SSR tests passed, confirming the documentation changes integrate seamlessly with the existing site.

✅ Passed (17)
Test Case Summary Timestamp Screenshot
ROUTE-1 Overview page at /talk-to-your-agents/slack/overview loads correctly with heading 'Slack Work App' and both Note components render including the new workspace limitation note. 0:46 ROUTE-1_0-46.png
ROUTE-2 Installation page loads with heading visible, two Note components rendered with workspace limitation text including Re-authorizing wording and uninstall requirement. 2:25 ROUTE-2_2-25.png
ROUTE-3 Configuration page loads with heading Configure Slack Agents, both Notes render correctly with the workspace limitation text and Installation link (href=/talk-to-your-agents/slack/installation). 4:11 ROUTE-3_4-11.png
ROUTE-4 Clicked Installation link in second Note on configuration page, navigation succeeded to installation page with heading and workspace limitation Note visible. 5:41 ROUTE-4_5-41.png
ROUTE-5 Navigated Overview->Installation->Configuration->Overview via sidebar links, all pages loaded with correct Note content. All four sidebar links present. 6:21 ROUTE-5_6-21.png
ROUTE-6 Commands page loads correctly with heading 'Using the Slack App'. The PR-specific workspace limitation text does NOT appear on this page, all existing sections render correctly. 7:40 ROUTE-6_7-40.png
EDGE-1 HTTP GET to /talk-to-your-agents/slack/installation returns 200, confirming the internal link from configuration page resolves correctly (not 404). 2:26 EDGE-1_2-26.png
EDGE-2 Two consecutive Note components on installation page with 16px gap between them, exceeding 8px minimum. No overlap detected. 2:27 EDGE-2_2-27.png
EDGE-3 Two Note components on overview page with 16px gap, both visually distinct with sky-blue background and left border. 0:47 EDGE-3_0-47.png
EDGE-4 Two Note components on configuration page with 84px spacing, no overlap, Installation link does not overflow container. 4:37 EDGE-4_4-37.png
EDGE-5 Installation link inside second Note is an anchor element with underline decoration, keyboard-focusable, does not overflow container. 4:35 EDGE-5_4-35.png
EDGE-6 TOC contains 14 unique heading entries, no Note content text appears in TOC. Expected section headings all present. 4:35 EDGE-6_4-35.png
EDGE-7 Verified at 375x812 viewport: both Note components on installation and configuration pages are fully visible without horizontal overflow or clipping. Installation link has adequate touch target. 9:38 EDGE-7_9-38.png
ADV-1 Performed 3 rapid navigation cycles without crashes, blank screens, or hydration errors. Final page rendered correctly with Note component. 10:40 ADV-1_10-40.png
ADV-2 Browser back/forward navigation maintained correct Note rendering across Overview, Installation, and Configuration pages. 7:06 ADV-2_7-06.png
ADV-3 At 280x600 viewport, the configuration page Note with Installation link rendered correctly, link visible, not clipped, and clickable. Navigation succeeded. 11:41 ADV-3_11-41.png
ADV-4 SSR verification via curl confirmed all three Slack documentation pages contain the workspace limitation Note text in server-rendered HTML. Configuration page also contains the Installation link. 12:27 ADV-4_12-27.png
📋 View Recording

Screen Recording

@amikofalvy amikofalvy merged commit e0ceb5a into main Feb 24, 2026
9 checks passed
@amikofalvy amikofalvy deleted the docs-writer-ai-update-2026-02-24T06-30-57-660Z branch February 24, 2026 07:17
@github-actions
Copy link
Copy Markdown
Contributor

🔎💬 Inkeep AI search and chat service is syncing content for source 'Inkeep Agent Framework Docs'

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.

1 participant