Notifications


Implementation Stories, in priority order

I see Comment Notifications in Summary form: That is, all of the new Comments in a single Space should get rolled up into a single visible Notification, whose header should be something like "14 new comments in Foo", and whose body shows as "3 comments on Bar; 5 comments on Floob", etc.
I can see the notifications in a single space: Should be a page with the notifications for this space down the left, and a main pane showing the current Thing.
I can click on a comment Notification and go to that Thing: The Thing shows in the large main pane.
When I go to a Thing, new comments are highlighted : Highlight should be subtle but clear.
I can exit Notification reading mode: Probably an exit button at the top of the notifications pane.
I can receive Notifications via email: This is a table-stakes features that everyone is going to want, so we will need to implement it sooner or later.
I receive a Notification when someone comments downthread of me: That is, the default should probably be that commenting in a thread "subscribes" you to that thread.
I can change my Notification Preferences and have them take effect immediately: On the Advanced page, there is a user preference for whether to receive all Comment Notifications in this Space. Problem is, it only takes effect after the Space next reloads.

Also referred to by

Choosing whether or not to receive Comment Notifications should work immediately: Currently, if you go to Actions -> Advanced... and choose to receive Comment Notifications, it doesn't take effect until the Space next reloads. That's annoying.
Comment Management should be more sensible: This needs design, but is clearly a design bug. This business of having to manually turn on Comment Notifications is proving stupid -- On should probably be the default, at least for Members with higher Roles than Commentator. Also, the UI for managing it is idiotic: we need something more straightforward, probably hooked off the Notification Icon.
I can change my Notification Preferences and have them take effect immediately: On the Advanced page, there is a user preference for whether to receive all Comment Notifications in this Space. Problem is, it only takes effect after the Space next reloads.
I can receive Notifications via email: This is a table-stakes features that everyone is going to want, so we will need to implement it sooner or later.
I receive a Notification when someone comments downthread of me: That is, the default should probably be that commenting in a thread "subscribes" you to that thread.
I should be able to Cc: people on Notifications: This is motivated by this Backbone story. The underlying idea is Cc'ing on the resulting emails, of course, but in order to achieve it we have to introduce a notion of Notification Cc:'s.
If you are logged out, and press the Notifications button, it hangs: That is, if I was logged in in this window, so the UI thinks I'm logged in, but I've either timed out or logged out in another window, I can still press the button. It fails silently; it should give an appropriate "you aren't logged in" error, and a button to log in.
Notification Rendering no longer works appropriately: This design bug isn't user-visible -- yet -- but shows up as a horrible hack in the Client's NotificationsPage. CommentNotifier shows the bug clearly. The issue is that we're rendering the link to the Comment deep in the server, inside CommentNotifier, but we really should be doing so client-side.
Rethink defaults and UI for Comment Notifications: At the moment, you have to explicitly turn on Comment Notifications from the Advanced page if you want to get them. That's probably wrong: they should be on by default, I think. Regardless, we need better UI for them.
When I read an emailed Notification about a Comment, it should mark the Comment as Read: It annoys me that few forum systems do this: until you actually go to the site, it remains unread, despite the fact that I have read the message.
Emailed Notifications to me should probably carry identifying information for me: See below, but the high concept is that, if Users can have multiple Identities, then emailed Notifications should probably carry information about which Identity the Notification was intended for.
I can click on a comment Notification and go to that Thing: The Thing shows in the large main pane.
I can easily navigate through the new comments: This should be something like CommYou or Wave -- I should just be able to keep hitting spacebar to navigate around the new information.
I can exit Notification reading mode: Probably an exit button at the top of the notifications pane.
I can mark a notification as read: That is, without actually following it.
I can mark all notifications as read: At least, all the ones in this Space.
I can see my received Notifications without losing my workflow context: Currently, clicking on the bell icon takes me to a system-wide Notifications page. This takes me out of my current Space, which can suck from a workflow POV.
I can see the notifications in a single space: Should be a page with the notifications for this space down the left, and a main pane showing the current Thing.
I can send a Notification message to everyone in this Space: This would have been highly desireable in ARC, especially coupled with being able to send Notifications out via email -- that way we could have sent Character Hints and Character Sheets at simple Notifications.
I see Comment Notifications in Summary form: That is, all of the new Comments in a single Space should get rolled up into a single visible Notification, whose header should be something like "14 new comments in Foo", and whose body shows as "3 comments on Bar; 5 comments on Floob", etc.
I should be able to receive Notifications natively on my device: That is, when a Comment comes in, it should pop up on my device, same as a tweet or a Facebook comment.
Notifications on Things that have been deleted are problematic: This isn't solely related to Comments, but those are the sharp end of the problem.
Sending System Message scales poorly: When I send a System Message, I am sending it individually to every User. That's a nice easy way to start, but is going to deeply suck when we have 10 million users.
When I delete a comment, it should withdraw notifications for that comment: If I've deleted the comment, it means it shouldn't exist. Which means that folks shouldn't be seeing notifications about it, either.
When I go to a Thing, new comments are highlighted : Highlight should be subtle but clear.

Closed Issues

As Admin, I can create a System Notification: That is, I can send a message to all Querki users. This will be hugely useful to me as we go forward, so we should probably start with it.
I can see an icon that tells me how many Notifications I have: This should be more or less the usual bell icon that everybody seems to use for this purpose nowadays.
I can see all of my Notifications: Initially, I click on my little bell icon, and get taken to a page showing all of the Notifications. Initially we don't worry about Summaries, since we just have the System Notifications.
I can click on a System Notification and read it: Keep in mind that all of the Notification stuff may want to happen under the current Space, as far as URLs are concerned, so that we don't lose context.
Client shouldn't be trying to load numNewNotifications if the user isn't logged in: It appears that Anonymous is still trying to fetch notifications. This is innocuous, but it's resulting in a lot of 400 errors in the client, from being rejected by the server.
I can see an icon that tells me how many Notifications I have: This should be more or less the usual bell icon that everybody seems to use for this purpose nowadays.
Errors while sending out _notify(): Eric is trying to send mass emails from the Spirit Island Space. He's seeing erratic behavior, and I'm seeing errors in the Splunk logs.
Comment Notifications don't use Computed Name: If you comment on a Thing that doesn't have a Name, you'll get a Notification titled, eg, Comment on ".bu6oc7u"
People shouldn't receive Comment Notifications for Things they can't Read: This is now a P0 security leak, so needs to be dealt with ASAP.
Make it easier to click on comment notifications: The arrow to click on, to go to the new comment, is fairly small -- not trivial to hit with a mouse, and worse on a phone. It would be easier if the entire header was clickable.
If I have no Notifications, the page hangs: This recipe still needs checking, but I think it's correct. If I am a new user, with no Notifications, and I go to the Notifications page, it hangs at Loading...
As Admin, I can create a System Notification: That is, I can send a message to all Querki users. This will be hugely useful to me as we go forward, so we should probably start with it.
I should be able to send a Notification from QL: This is the heart of adding the ability to send email from Querki in userland code.
I can control whether I receive comment notifications in this Space: As Owner I can turn them off. As Member, I can turn them on.
Notifications aren't working?: Not sure of the details, but I don't seem to be getting Alexx' comments as notifications in this Space, at least.
I can click on a System Notification and read it: Keep in mind that all of the Notification stuff may want to happen under the current Space, as far as URLs are concerned, so that we don't lose context.
I can see all of my Notifications: Initially, I click on my little bell icon, and get taken to a page showing all of the Notifications. Initially we don't worry about Summaries, since we just have the System Notifications.