On this page

What watching is for#

When a spec matters to you, you want to know when it moves on: when it reaches Ready for development, when a new version goes live, when someone proposes a change you need to approve. Watch the article, or the category it lives in, and DevStride tells you.

Watching an article#

Open the article in the editor. In the Status & lifecycle panel, click Watch beside the article's state. It turns to Watching; click it again to stop.

Beside Watch are the avatars of the people watching the article: the first three, then +N for the rest. Hover over them to see every watcher's name.

Watching a category#

On Manage articles, open a category's ⋯ menu and choose Watch category. A bell then appears on the category in the tree. Choose Stop watching from the same menu to stop.

Watching a category covers every article filed in it and in every subcategory beneath it, including articles added later.

Anyone who can read an article or category can watch it; no extra permission is needed. If a category is deleted, its watches go with it, while watches on its articles stay.

Adding and removing other watchers#

Like a work item, every article and category has a watcher list, and some people can add colleagues to it or take them off, so the right people hear when a spec moves on.

  • An article: in the editor's Status & lifecycle panel, click the watcher avatars beside Watch (a person icon when nobody is watching yet). The Select watchers picker opens.
  • A category: on Manage articles, open the category's ⋯ menu and choose Manage watchers….

Pick the people who should watch, clear the ones who should not, and click Update Watchers. Only active members of your organization can be added.

To You need
See who watches an article Being able to read it
Watch or stop watching yourself Being able to read it
Add or remove someone else on an article Edit access to the article: Create knowledge-base articles plus the access that lets you edit its content (you wrote it, a Can edit share, or Edit any member's knowledge-base articles)
Add or remove someone else on a category Publish knowledge-base articles or Edit any member's knowledge-base articles

Without that access the avatars are still shown, but clicking them does nothing. A category's watchers are listed only in the Select watchers picker, so in the app only people who can manage them see the list.

Someone you add is not notified that you added them; they start receiving the notifications below. A person added to an article they cannot read is still not told about it (see Who is not told).

What you are told about#

You get an in-app notification when a watched article, or an article in a watched category:

Something happened The notification
Moved to another stage A specification you watch moved to stage followed by the stage's name
Taken out of its stage A specification you watch was taken out of its stage
Was published, so a new version went live A specification you watch has a new published version
Had a change submitted for approval A change was proposed to a specification you watch
Had its proposed change approved A proposed change to a specification you watch was approved and published
Had its proposed change sent back A proposed change to a specification you watch was sent back
Had its proposed change withdrawn A proposed change to a specification you watch was withdrawn
Fell out of sync with a linked work item, because an as-built note could not be added A specification is out of sync: a work item it covers changed, and the as-built note could not be added
Had new differences found by a spec check of finished work Finished work differs from a specification: open the spec to review the differences

Clicking a notification opens the article in the editor; the out-of-sync one opens its As-built changes section. That one also goes to the spec's author, whether or not they watch it, and, when no one else can be told, to the people who hold Publish knowledge-base articles.

Ordinary edits to an article are not announced.

Comments on articles you watch#

You can also hear about every new comment and reply on a watched article, or on any article in a watched category, from your team or from customers. This is your Watcher setting for Comments modified in notification settings, the same setting that covers work items you watch. It is off until you tick it, and it arrives on the channels you tick it for: the app, email, Slack or Microsoft Teams. If you are also mentioned or already in the thread, you hear about the comment once, as described in Article review comments.

Who is not told#

  • The person who did it. You are never notified about your own change.
  • Anyone who cannot read the article now. If an article is a draft you cannot see, or is no longer shared with you, you are not told about it, even if you watch its category.
  • Anyone twice. Watching both an article and its category still gets you one notification per change.

Stage, version, proposed-change and out-of-sync notifications appear in the app only. They are not sent by email, Slack or Microsoft Teams. Comment notifications follow your Comments modified setting instead.

Powered by DevStride