Skip to content

[SC-18631] Document Announcements and the My Inbox dashboard widget - #1522

Merged
emmavdh merged 7 commits into
mainfrom
emma/sc-18631/announcements-and-my-inbox-widget
Oct 2, 2026
Merged

emmavdh merged 7 commits into
mainfrom
emma/sc-18631/announcements-and-my-inbox-widget

Conversation

@emmavdh

@emmavdh emmavdh commented Sep 30, 2026 •

Copy link
Copy Markdown
Collaborator

What and why?

Documents two 26.10 features from the Docs 26.10 tracker (sc-18631):

  • Announcements (sc-18337; backend #3658 merged, frontend #2950 open and expected before the cut): Customer Admins publish organization-wide notices from Settings → Announcements with Info / Warning / Critical levels, delivered to every member's My Inbox; critical ones are pinned, undismissable while live, emailed, and open the Inbox after sign-in.
  • My Inbox dashboard widget (sc-18336; frontend #2927, backend #3663) and the Inbox redesign (sc-18373; frontend #2912).

Changes:

  • New guide/configuration/manage-announcements.qmd: how announcements work, create, schedule or publish, retire / duplicate / delete, critical email. Registered in guide/_sidebar.yaml and the Managing your organization listing.
  • guide/configuration/manage-platform-notifications.qmd: adds the Announcements update type and the Critical announcements email event.
  • guide/configuration/customize-your-dashboard.qmd: adds My Inbox under the Other widget type.
  • guide/configuration/manage-platform-notifications.qmd (Inbox guide, sc-18373 and sc-18336): rewrites the filter, mark-as-read and dismiss steps for the redesigned rows (Update type / Show filters with chips, hover-to-select checkboxes, selection bar, Mark all as read, Restore, opening an update marks it read) and adds an Add My Inbox to your dashboard section noting that filters and multi-selection stay in the sidebar inbox and the widget is not on default dashboards.

How to test

Preview links (allow time for the preview deploy):

What needs special review?

  • First pass, draft. Screenshots to follow (Settings → Announcements list and detail, an announcement row in My Inbox, the My Inbox widget).
  • UI labels are taken from the copy strings in frontend #2950 (Add Announcement, Create Draft, Schedule, Publish Now, Retire, Duplicate, Delete; statuses Draft / Scheduled / Live / Retired / Expired). The email event label is Critical announcements (backend email_events_registry), not "Announcements (critical)" as the tracker task says.
  • The Inbox guide has no screenshots today, so there is nothing to refresh for the redesign; new ones (redesigned rows, selection bar, My Inbox widget) would help and can be added with the announcement screenshots.
  • Inbox UI labels are taken from the copy strings on frontend main (Update type, All types, Show, Unread only, Dismissed only, Clear all, Mark as read, Mark as unread, Dismiss, Restore, Select all loaded updates, Mark all as read).
  • Announcements ship behind launchdarkly.rollout.announcements-inbox, off by default; on at release per Emma.

Dependencies, breaking changes, and deployment notes

Release notes

Documented organization-wide Announcements for Customer Admins and the My Inbox dashboard widget.

Checklist

  • What and why
  • How to test
  • What needs special review
  • Dependencies, breaking changes, and deployment notes
  • Labels applied
  • PR linked to Shortcut

🤖 Generated with Claude Code

@emmavdh emmavdh added the documentation Improvements or additions to documentation label Sep 30, 2026
@emmavdh
emmavdh force-pushed the emma/sc-18631/announcements-and-my-inbox-widget branch 2 times, most recently from dd5fd5b to 658b43b Compare October 2, 2026 01:14
@emmavdh
emmavdh marked this pull request as ready for review October 2, 2026 01:15
@emmavdh
emmavdh requested review from gtagle and panchicore October 2, 2026 01:15

@panchicore panchicore left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks Emma, this reads well. Most of it checks out against the app: who can create, statuses, Retire, Duplicate, Delete, critical email, late joiners, audit, and the inbox labels. Three lines don't match what's on screen, though:

  1. manage-announcements.qmd:40: the button is Create Draft, not Save Draft (settings.announcements.action.createDraft in the frontend copy). The PR body's label list has the same slip.
  2. customize-your-dashboard.qmd:223 and manage-platform-notifications.qmd:110: the My Inbox widget does have filters and bulk selection now. Frontend #2952 (merged Sep 24) brought the drawer's Filter menu, chips, checkboxes and selection bar to the widget. Suggest saying it has the same filters, selection and per-item actions as the sidebar inbox.
  3. manage-platform-notifications.qmd:74: Mark all as read is a toolbar button next to Filter, not in a ⋮ menu. It also only marks the loaded unread updates that match the current filters, not every update. Maybe: "To mark all loaded updates as read, click Mark all as read in the toolbar above the list."

Small, optional:

  • manage-platform-notifications.qmd:50 (older than this PR): older updates load as you scroll. Load more only shows when filters hide everything loaded so far.
  • manage-announcements.qmd:23: Info and Warning differ in icon and color (blue vs yellow tint).

One question, not for this PR: live Info/Warning announcements are also pinned (just below critical), while the in-app help says "Only Critical is pinned". I'll raise that on the product side; the docs can stay as they are.

emmavdh and others added 5 commits October 2, 2026 10:21
Adds a Manage announcements page (Settings > Announcements: levels, lifecycle,
create, schedule, publish now, retire, duplicate, delete, critical email) and
registers it in the sidebar and the Managing your organization listing. Adds
the Announcements update type and the Critical announcements email event to
the platform notifications page, and the My Inbox widget to the dashboard
widget docs.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…d My Inbox widget

Rewrites the filter, mark-as-read and dismiss steps for the redesigned Inbox
rows (sc-18373: Update type and Show filters with chips, hover-to-select
checkboxes, selection bar, Mark all as read, Restore, opening an update marks
it read) and adds an Add My Inbox to your dashboard section (sc-18336).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Replaces the placeholder wording with one bullet per widget, using the
labels from the Add Widget picker (Model Artifacts, Activity Feed, My Inbox).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@emmavdh
emmavdh force-pushed the emma/sc-18631/announcements-and-my-inbox-widget branch from 39f4f47 to 069b300 Compare October 2, 2026 14:21
emmavdh and others added 2 commits October 2, 2026 10:23
From Luis Pallares's review: the create button is Create Draft; the My Inbox
widget has the same filters and selection as the sidebar inbox (frontend
#2952); Mark all as read is a toolbar button that marks only the loaded
updates matching the current filters; older updates load on scroll, with
Load more shown when filters hide everything loaded; Info and Warning
levels differ in color as well as icon.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Product decision after Luis Pallares's review: the Inbox pins every live
announcement above other updates, Critical first (backend
_announcement_pin_rank, frontend splitPinnedAnnouncements). Only the
no-dismiss rule and the email are Critical-only. The in-app help text is
being corrected in the frontend to match.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@emmavdh

emmavdh commented Oct 2, 2026

Copy link
Copy Markdown
Collaborator Author

Thanks @panchicore , all five applied: Create Draft, the widget's filters and selection (#2952), Mark all as read as a toolbar action on the loaded updates, load-on-scroll with Load more, and the level colors. The PR body label list is fixed too.

On pinning, I'm making the product call now rather than leaving it open: pinning stays as built. Every live announcement is pinned above other updates, Critical first, and only the no-dismiss rule and the email are Critical-only. I've updated both pages here to say that, and opened validmind/frontend#2983 (sc-18732) to correct the page description and Level help text in Settings so the app says the same thing. Would appreciate your eyes on that one as well.

Ready for another look when you have a minute.

@emmavdh
emmavdh requested a review from panchicore October 2, 2026 14:37
@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

Validate docs site

✓ INFO: A live preview of the docs site is available — Open the preview

@panchicore panchicore left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

🌮

All three fixed (Create Draft, widget filters and selection, Mark all as read in the toolbar, loaded only), plus the scroll/Load more and the blue/yellow levels. The pinned wording now matches the app and frontend #2983. Thanks!

@gtagle gtagle left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Looking goood

@emmavdh
emmavdh added this pull request to the merge queue Oct 2, 2026
Merged via the queue into main with commit c840b9d Oct 2, 2026
4 of 5 checks passed
@emmavdh
emmavdh deleted the emma/sc-18631/announcements-and-my-inbox-widget branch October 2, 2026 17:35
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.

3 participants