Loomio
Wed 11 Feb 2015 8:48AM

Call for API User stories for W3C Social WG

EP elf Pavlik Public Seen by 104

Howdy o/

In the W3C Social WG we currently work on gathering User Stories for the
Social API (client to server API) specification (server to server API
coming soon!). We would like to welcome your feedback and especially
submitting stories which Diaspora currently supports. Simple steps to do
that:

  1. Visit https://www.w3.org/wiki/Socialwg/Social_API/User_stories
  2. Read all the stories and collect # links to those which Diaspora supports
  3. Write new stories, trying to keep same convention, for other features which Diaspora supports
  4. Publish those new stories online and send link by email to [email protected] with subject: Diaspora API User stories

We will include them on:
https://www.w3.org/wiki/Socialwg/Social_API/User_stories#Existing_Platforms

Please keep in mind the deadline for submitting your stories - 1 week
from now! (Feb 16th, 2015)

Thank you :)

EP

elf Pavlik Wed 11 Feb 2015 9:10AM

@jasonrobinson @jhass @dennisschubert
https://twitter.com/elfpavlik/status/565435083025575937

DU

Deleted account Wed 11 Feb 2015 2:31PM

Hmm... What are users stories ?

JR

Jason Robinson Wed 11 Feb 2015 7:14PM

Thanks @elfpavlik for keeping us informed!

@augier User story by wikipedia. This is related to the work done in W3C to standardize the way social apps like diaspora talk to each other.

EP

elf Pavlik Thu 12 Feb 2015 1:30PM

Most crucial for us part: please document stories which cover your already existing functionality! This way we can make sure that specs with take into account all the requirements for implementing features, which people using Diaspora already got used to. Please also keep this very near deadline in mind!

DU

Dumitru Ursu Thu 12 Feb 2015 9:18PM

One feature that was asked from us is retrieving a user directly, without interrogation for the server webfinger, to cut down the roundtrips to the server. I don't know if the issue is with the spefication, our server implementation, or their clients implementation (maybe the client can cache the first response for a few hours).

Also, retrieving a json with 2 or more users at once, for the same reason: less delay. I think I saw this on loomio or GH issues, maybe somebody remembers where it was.

DU

Deleted account Fri 13 Feb 2015 8:35PM

Looks like there's already a bunch of users stories.

JR

Jason Robinson Sat 14 Feb 2015 7:16AM

nervously looks at deadline and tries to find some time today for this

JR

Jason Robinson Sun 15 Feb 2015 9:25PM

@elfpavlik Phew! Added quite a few from the diaspora* world. I don't think the current suggested ones there already fitted very well. And quite a few are very broadly written, so some of the ones I added are mentioned in others, but they don't have their own user story. But yeah, will have another pass tomorrow, adjust and do more additions - then will hit the mailing list with a note and a list.

G

goob Mon 16 Feb 2015 12:11PM

Thanks, Jason - you're a project super-hero at the moment!

JR

Jason Robinson Tue 17 Feb 2015 3:22PM

@elfpavlik Did a few additions but can't do much more checking at the moment as I got hit by fever.

Anyway, sent an email to the list and the user stories are here: https://cloud.jasonrobinson.me/index.php/s/x5eOHEzCecnqpLm