Files
buzz/CONTEXT.md
2026-10-18 16:58:15 -07:00

3.2 KiB

Buzz domain language

Shared terminology for Buzz product behavior. This glossary currently covers mobile notification eligibility and push suppression; it is not a complete model of Buzz.

Notifications

Mobile push notification

A notification directed to a user's mobile installation through the platform's push service.

Push suppression

Withholding an otherwise eligible mobile push notification based on desktop activity and a working connection to the relevant community. It does not depend on whether desktop alerts can be shown.

Avoid: Read receipt, mark as read, mute

Desktop activity

User interaction with the computer running Buzz, including interaction with another application. It is the interaction itself, not a state that lasts afterward, and does not imply that a particular Buzz message was displayed or read.

Avoid: Message visibility, read activity

In-app activity

User interaction inside Buzz. Recent in-app activity remains evidence of desktop activity after Buzz loses focus; current window focus is a separate condition.

Desktop inactivity

The state reached when the duration specified in the spec has elapsed since the last observed desktop activity.

Additional notification delay

A waiting period after desktop inactivity begins before mobile push notifications resume. This is distinct from the inactivity threshold itself.

Suppressed message

A message whose otherwise eligible mobile push notification was withheld. The term refers to its notification, not withholding the message itself, and says nothing about whether the message has been read.

Suppression activity signal

Information communicated for deciding whether desktop activity warrants push suppression. It is distinct from visible presence and is not a read receipt.

Visible presence

The availability status shown to other members, such as online, away, or offline. A chosen visible presence status does not necessarily reflect actual desktop activity.

Suppression renewal

A suppression activity signal that extends how long push suppression applies based on activity on one desktop.

Inactivity cutoff

The time of the last observed desktop activity plus the duration specified in the spec, when desktop inactivity begins. New desktop activity moves this cutoff forward.

Thread root

The message identifying the outer thread containing a reply. A nested reply can have a different immediate parent while retaining the same thread root.

Authored-thread reply

A message by another author in a thread whose root was authored by the notification recipient. This includes nested replies and does not imply an explicit follow or a prior mention.

Push eligibility

Whether a message qualifies for a recipient's mobile push notification. Eligibility does not guarantee delivery or presentation, which remain subject to notification controls, suppression, and platform behavior.