@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
Document the new watcher/member/edit notification mail rules
Summary: Ref T10054. This is mostly for completness so I can reference it when closing all the related tasks.
Test Plan: Read documentation.
Reviewers: chad
Reviewed By: chad
Maniphest Tasks: T10054
Differential Revision: https://secure.phabricator.com/D15066
+62
+9
src/applications/project/application/PhabricatorProjectApplication.php
+9
src/applications/project/application/PhabricatorProjectApplication.php
+53
src/docs/user/userguide/projects.diviner
+53
src/docs/user/userguide/projects.diviner
···
1
+
@title Projects User Guide
2
+
@group userguide
3
+
4
+
Organize users and objects with projects.
5
+
6
+
Overview
7
+
========
8
+
9
+
NOTE: This document is only partially complete.
10
+
11
+
Phabricator projects are flexible groups of users and objects.
12
+
13
+
14
+
Joining Projects
15
+
================
16
+
17
+
Once you join a project, you become a member and will receive mail sent to the
18
+
project, like a mailing list. For example, if a project is added as a
19
+
subscriber on a task or a reviewer on a revision, you will receive mail about
20
+
that task or revision.
21
+
22
+
If you'd prefer not to receive mail sent to a project, you can go to
23
+
{nav Members} and select {nav Disable Mail}. If you disable mail for a project,
24
+
you will no longer receive mail sent to the project.
25
+
26
+
27
+
Watching Projects
28
+
=================
29
+
30
+
Watching a project allows you to closely follow all activity related to a
31
+
project.
32
+
33
+
You can **watch** a project by clicking {nav Watch Project} on the project
34
+
page. To stop watching a project, click {nav Unwatch Project}.
35
+
36
+
When you watch a project, you will receive a copy of mail about any objects
37
+
(like tasks or revisions) that are tagged with the project, or that the project
38
+
is a subscriber, reviewer, or auditor for. For moderately active projects, this
39
+
may be a large volume of mail.
40
+
41
+
42
+
Edit Notifications
43
+
==================
44
+
45
+
Edit notifications are generated when project details (like the project
46
+
description, name, or icon) are updated, or when users join or leave projects.
47
+
48
+
By default, these notifications are are only sent to the acting user. These
49
+
notifications are usually not very interesting, and project mail is already
50
+
complicated by members and watchers.
51
+
52
+
If you'd like to receive edit notifications for a project, you can write a
53
+
Herald rule to keep you in the loop.