StoryBoard/Notifications

meeting irc logs here: http://eavesdrop.openstack.org/meetings/storyboard/2015/storyboard.2015-11-18-15.00.log.html

followup in #storyboard here: http://eavesdrop.openstack.org/irclogs/%23storyboard/%23storyboard.2015-11-18.log.html#t2015-11-18T15:46:32

To be worked into a more readable spec for notifications, that will form the backbone of a roadmap for the next few months of StoryBoard development.

Spec
----

A user needs to know:

1. When something (that affects that user) updates (in a way that affects that user)

Requirements:

a) Things that affect users must be tracked. Selectable subscriptions exist. If not all things that can be updated in a subscribed resource will be relevant, then...

b) SB needs to track whether or not an update to a (subscribed) resource is relevant to the user.

  i) What updates are possible?

  ii) How will a user tell SB which updates to look out for?

c) SB must inform user of these updates

  i) The user needs to know *what* has updated

        *Appropriate metadata should be relayed-- what is it, and should this be configurable?
        (example of appropriate metadata: 'what groups does the updated resource fall into?', 'when was it updated?', 'does this update require my input?')

  ii) The user should be notified in the most suitable way. What is this, and should *this* be configurable? (eg: what channels? how frequently should a user be notified?)

Implementation:

TBA, look into timeline events. Roughly divides into three parts:

a) SB tracking info

b) Info displayed to user

    i) currently:

        *recent events on dashboard

    ii) in progress

        *email notifications patches
        (what point are these at?)
         
c) Info interactive

    i) currently:
      
        *preferences for timeline events accessed from profile page

        *checkboxes with 'save' button at the bottom:

            Story created
            Story details changed
            Task created
            Task assignee changed
            Task status changed
            Task priority changed
            Task details changed
            Task deleted
             User comment

        *linked from 'profile' button on left navbar

Timeline: 

When do we expect what? We could probably refine this forever, so at what point should we consider changing priority?