Skip to content

docs: document reserved dm key and fail-closed audience parsing#33

Merged
Aaronontheweb merged 1 commit into
devfrom
docs/channel-audience-override-details
May 19, 2026
Merged

docs: document reserved dm key and fail-closed audience parsing#33
Aaronontheweb merged 1 commit into
devfrom
docs/channel-audience-override-details

Conversation

@Aaronontheweb
Copy link
Copy Markdown
Contributor

What

Documents two previously unstated details in the Slack and Discord Audience overrides sections.

  • The "dm" key in a ChannelAudiences map is reserved — it matches every direct message rather than a channel ID. The pages showed "dm" in an example without explaining it.
  • A channel-ID entry takes precedence over the "dm" fallback.
  • An unrecognized audience value is denied (fail-closed), not silently defaulted.

Why

Both behaviors are enforced in src/Netclaw.Channels/AudienceResult.cs (shared by Slack and Discord). The fail-closed detail used to live in the Hardening page's Slack section, which was made channel-agnostic in #32 — these facts belong on the channel pages where the config is documented.

Verification

  • npm run build passes (55 pages).

The Slack and Discord audience override sections showed the "dm" key
in a ChannelAudiences example without explaining it. Note that "dm"
is reserved (matches every direct message, not a channel ID), that a
channel-ID entry takes precedence over it, and that an unrecognized
audience value is denied rather than defaulted.
@Aaronontheweb Aaronontheweb enabled auto-merge (squash) May 19, 2026 03:32
@Aaronontheweb Aaronontheweb merged commit d3ad053 into dev May 19, 2026
2 checks passed
@Aaronontheweb Aaronontheweb deleted the docs/channel-audience-override-details branch May 19, 2026 03:34
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