Skip to content

docs: give the three unlinked slack commands their own sections - #136

Merged
Jamyn merged 3 commits into
mainfrom
docs/link-slack-commands-82
Aug 15, 2026
Merged

Jamyn merged 3 commits into
mainfrom
docs/link-slack-commands-82

Conversation

@Jamyn

@Jamyn Jamyn commented Aug 15, 2026

Copy link
Copy Markdown
Owner

Closes #82.

/dispatch-list-incidents, /dispatch-list-signals and /dispatch-summary were listed on the Incident Commander page as plain code spans with no section to link to. Each now has one, written from the handlers rather than from the admin table.

The admin table's <organization-slug>/<project-slug> signatures are removed from /dispatch-list-incidents and /dispatch-report-incident: slack_bolt only dispatches when payload["command"] matches the registered name exactly, so the code reading arguments out of it is unreachable and that syntax has never worked (#133).

Guarded by onBrokenAnchors: "throw" plus a list/section consistency check in docs/scripts, run from a new unfiltered docs-checks job — promote it to a required check once it is on main, which is what makes this blocking rather than advisory.

Screenshots deferred to #135; #134 tracks three commands documented nowhere.

Jamyn added 2 commits August 15, 2026 20:44
Also drops <organization-slug>/<project-slug> from the admin command table:
handle_list_incidents_command splits payload["command"], which holds the
slash-command name and never the arguments, so that branch is unreachable and
the syntax has never worked. handle_report_incident_command reads no arguments
at all.

Adds onBrokenAnchors: "throw" and a list/section consistency check, run from a
new unfiltered docs-checks job so it can later be made a required check.
@Jamyn Jamyn added the documentation Improvements or additions to documentation label Aug 15, 2026
Comment thread docs/scripts/check-command-links.mjs Fixed
@Jamyn
Jamyn merged commit ebc935e into main Aug 15, 2026
13 checks passed
@Jamyn
Jamyn deleted the docs/link-slack-commands-82 branch August 15, 2026 21:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Three Slack commands on the Incident Commander page have no documentation link

2 participants