Diff for "yellow/Subscriptions"

Not logged in - Log In / Register
Differences between revisions 2 and 3
⇤ ← Revision 2 as of 2011-01-19 19:01:37 →
Size: 2141
Editor: benji
Comment:
← Revision 3 as of 2011-01-19 20:38:43 → ⇥
Size: 3422
Editor: benji
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Adding bug target subscriptions= = Definitions =
Line 3: Line 3:
If a user wants to subscribe to a bug target (normally a project), they will
visit the project page and see a link with a plus icon with the text "Add a bug		 A "structural subscription" is a subscription to an entity that contains bugs
(i.e., a project).

A "direct subscription" is a subscription to an individual bug.


= Adding structural subscriptions =

If you want to subscribe to a bug target (normally a project), you visit the
project page and click on the link with a plus icon with the text "Add a bug
Line 7: Line 15:
Upon clicking on the link the user will be presented with a page overlay that
contains an accordion with controls for the kinds of messages they will receive
(figure XXX). After configuring the subscription the user will click on the OK		 Upon clicking on the link you will be presented with a page overlay that
contains an accordion with controls for the kinds of messages you want to
receive (figure XXX). After configuring the subscription, click on the OK
Line 11: Line 19:
user on the project page. Below the add link a new "Edit bug mail
subscriptions" link will appear.		 you on the same page you started on. Below the add link a new "Edit bug mail
subscriptions" link will appear below the existing "Add a bug mail
subscription" link.
Line 15: Line 24:
= Editing bug target subscriptions = = Editing structural subscriptions =
Line 17: Line 26:
If a user wants to edit their subscriptions to a bug target they visit the
project page and see a link with the yellow pencil icon and the text "Edit bug
mail subscriptions". When the user clicks on the link they are taken to a page
which lists all of the subscriptions for the current project (figure XXX).		 If you want to edit your subscriptions to a bug target (e.g. project), visit
the project page and click the link with the yellow pencil icon and the text
"Edit bug mail subscriptions". You will then be taken to a page which lists
all of your subscriptions for the current project (figure XXX).
Line 22: Line 31:
When the user clicks "edit" on one of the listed subscriptions they are
presented with the subscription edit dialog (figure XXX). Note that the "Who"
section is static text and can not be changed.		 Each listed subscription has an edit link which you can click to be presented
with the subscription edit dialog (figure XXX). Note that the "Who" section is
static text and can not be changed.
Line 26: Line 35:
= Adding direct bug subscriptions =
Line 28: Line 36:
When viewing a bug the user can click on the "Subscribe" link (which should
have a green plus icon) to subscribe to a bug. They will then see an overlay		 = Adding direct subscriptions =

When viewing a bug you can click on the "Subscribe" link (which should have a
green plus icon) to subscribe to that bug. You will then see an overlay
Line 32: Line 42:
The first accordion will be a user/team search form with the current user's name already filled in.  The first accordion panel is a user/team search form with your name already
filled in.
Line 34: Line 45:
If the user wants to subscribe someone else or a team for which they are an
admin they can type a substring of the name into the search field and click on
the magnifying glass icon. They will then be given a batched listing of the
search results and be able to search more or click on one of the results to
populate the text box.		 You want to subscribe someone else or a team for which you are an admin you can
type a substring of the name into the search field and click on the magnifying
glass icon. You will then be shown a batched listing of the search results and
be able click on one of the results to populate the text box or perform another
search.
Line 40: Line 51:
- top two panels (who and events) If you only want to receive emails for some bug events (say only comments), you
can do so on the second (and only other) accordion pane.
Line 43: Line 56:
= Editing all of "my" subscriptions =
When viewing a bug you can click the "Edit bug mail subscriptions" link (with a
yellow pencil icon next to it) to change the types of messages you receive
about that bug.

You will be presented with a two-pane accordion much like that described in the
section on "Adding direct subscriptions" except that the subscribed user will
be static text.

= Editing all of your subscriptions =

= Email from structural subscriptions =
Line 49: Line 73:
- project page
- the link to edit subscriptions on a project page should lead to a page that
  shows the user's structural subscriptions to the project in question as well
  as the teams subscripts to that project for which the user is an admin
- the user's page should have an "Edit subscriptions" link that leads to a page
  that shows all the user's structural subscriptions and lets them edit them
- a team's page needs an "Edit subscriptions" link that shows all of that
  project's structural subscriptions to all projects and lets admins of the
  team edit them

Definitions

A "structural subscription" is a subscription to an entity that contains bugs (i.e., a project).

A "direct subscription" is a subscription to an individual bug.

Adding structural subscriptions

If you want to subscribe to a bug target (normally a project), you visit the project page and click on the link with a plus icon with the text "Add a bug mail subscription".

Upon clicking on the link you will be presented with a page overlay that contains an accordion with controls for the kinds of messages you want to receive (figure XXX). After configuring the subscription, click on the OK button at the bottom of the overlay and the overlay will disappear, leaving the you on the same page you started on. Below the add link a new "Edit bug mail subscriptions" link will appear below the existing "Add a bug mail subscription" link.

Editing structural subscriptions

If you want to edit your subscriptions to a bug target (e.g. project), visit the project page and click the link with the yellow pencil icon and the text "Edit bug mail subscriptions". You will then be taken to a page which lists all of your subscriptions for the current project (figure XXX).

Each listed subscription has an edit link which you can click to be presented with the subscription edit dialog (figure XXX). Note that the "Who" section is static text and can not be changed.

Adding direct subscriptions

When viewing a bug you can click on the "Subscribe" link (which should have a green plus icon) to subscribe to that bug. You will then see an overlay containing an accordion and OK/Cancel buttons.

The first accordion panel is a user/team search form with your name already filled in.

You want to subscribe someone else or a team for which you are an admin you can type a substring of the name into the search field and click on the magnifying glass icon. You will then be shown a batched listing of the search results and be able click on one of the results to populate the text box or perform another search.

If you only want to receive emails for some bug events (say only comments), you can do so on the second (and only other) accordion pane.

Editing direct bug subscriptions

When viewing a bug you can click the "Edit bug mail subscriptions" link (with a yellow pencil icon next to it) to change the types of messages you receive about that bug.

You will be presented with a two-pane accordion much like that described in the section on "Adding direct subscriptions" except that the subscribed user will be static text.

Editing all of your subscriptions

Email from structural subscriptions

additions: - emails have a link to why you got it - select all and select none links at the top of every checkbox forest panel - project page - the link to edit subscriptions on a project page should lead to a page that

  • shows the user's structural subscriptions to the project in question as well as the teams subscripts to that project for which the user is an admin

- the user's page should have an "Edit subscriptions" link that leads to a page

  • that shows all the user's structural subscriptions and lets them edit them

- a team's page needs an "Edit subscriptions" link that shows all of that

  • project's structural subscriptions to all projects and lets admins of the team edit them

yellow/Subscriptions (last edited 2011-03-21 12:55:29 by danilo)