I finally pieced together my thoughts on the Social API over the last couple of weeks, and yesterday it was accepted as an Editor's Draft for the W3C Social WG. Over the next month or so I'm hoping the group can work together to plug the gaps and reach consensus where there are various alternative ways of doing things so we can have a First Public Working Draft by our next face-to-face on the 1st of December.
social api (2 out of 2)
- List required functionality from each user story.
- Cluster related functionality, find overlap between stories (see colours/tags).
- Organise requirements into shortlist.
- According to some filter, eg. by a certain user, posted to a certain group.
- Undo a subscription.
- Including text, photo, video, audio.
- Including metadata and relations to other things, ie. audience/to, tags, reply-to, likes.
- Update published content.
- Delete published content.
- User is somehow alerted when content is created that explicitly targets them (ie. as recipient or subject).
- According to permissions.
- Discovery of content according to criteria:
- type (text, photo..);
- associated with group;
- created by a particular user;
- by the content's target (replies/likes of a particular post).
- Publishing a photo. pub
- Push notifications. notif
- Subscription to a user. sub
- Commenting on / replying to a post. pub
- Publishing text content. pub
- Updating published text. pub
- Deleting published text. pub
- Reading comments / replies. read
- Reading posts from a particular user. read
- Viewing photos from a particular user. read
- Subscription to a user. sub
- Publishing a photo. pub
- See a user's subscriptions. sub
- Read posts from a particular user. read
- Unsubscribe from a user. sub
- Subscribe to a user (one way). sub
- Join a group ~= subscribe to group content. sub
- Publish a video. pub
- Publish audio. pub
- Private sharing. read
- Publish subscriptions. sub
- Liking / recommending a post. pub
- Subscribe to a user. sub
- View likes of a post. read
- Posting from one interface to another system (scope?)
- Reply to posts. pub
- Notifications. notif
- Subscribe to a user. sub
- Posting from one interface to another system (scope?)
- Publishing text content. pub
- Private sharing; specifying audience. read
- Notifications. notif
API requirements derived from user stories
Draft post, in preparation for posting to SocialWG wiki
So far completed for approved user stories. ~~~~
Note: These requirements are deliberately limited by the contents of the user stories. If things seem obviously missing, this is because they were not referenced in the user stories. I've tried not to over-generalise when summarising them, too.
Process:
Requirements shortlist
In no particular order. Tags/colours map to requirements by story, below.