Skip to content

docs: add Slack setup screenshots and describe the scope picker - #223

Merged
svadrutk merged 4 commits into
mainfrom
docs/slack-prefilled-setup
Oct 20, 2026
Merged

svadrutk merged 4 commits into
mainfrom
docs/slack-prefilled-setup

Conversation

@svadrutk

Copy link
Copy Markdown
Contributor

Follow-up to #222.

What changed

  • Adds four screenshots to the Slack guide, stored in guides/slack/assets/ and declared in meta.yaml:
    • Slack's Create from a manifest dialog opened from the prefilled link
    • Basic Information → App Credentials (values replaced with placeholders)
    • Control Plane Settings → Identity with User Identity, the Slack provider, Manual credentials, and all 30 scopes (placeholder credentials)
    • Danger Zone → Server Availability
  • Updates step 4 of speakeasy.md: Scope is now a multi-select list, so the step says to select the scopes rather than paste a space-separated list. research.md is updated to match.

Notes

  • The <!-- screenshot: … --> comments stay in place, because guide lint requires one in each step.
  • The screenshots are 506–776 px wide, limited by the capture tool.
  • The Identity screenshot comes from a temporary server in the swad-test project.

Verification

  • go run ./cmd/lint-guide ../guides/slack passes.
  • go/internal/gen accepts the asset paths and hashes.

svadrutk and others added 4 commits October 20, 2026 14:21
Add four screenshots to the Slack guide: the prefilled manifest dialog,
App Credentials, Identity with Manual credentials and all 30 scopes, and
Server Availability. Credential values are placeholders.

The Control Plane now selects scopes from a multi-select list, so step 4
describes that instead of pasting a space-separated list.
@svadrutk
svadrutk merged commit f667efd into main Oct 20, 2026
1 check passed
@svadrutk
svadrutk deleted the docs/slack-prefilled-setup branch October 20, 2026 21:48
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