Feedback on Atom Activity Base Schema

2 views
Skip to first unread message

Beau Lebens

unread,
Aug 15, 2009, 6:42:29 PM8/15/09
to activity...@googlegroups.com
Hi All,

It's quite possible that I'm repeating previous comments or am
off-mark in some other way, but I was tinkering about today and read
through http://martin.atkins.me.uk/specs/activitystreams/activityschema
and wanted to post up some comments/suggestions/fixes for the
document, in case anyone finds them useful:

- there are some missing references to what element should be used
(and the specific details of that element) for certain pieces of data,
e.g. Article > summary

- Many mime types reference text/html, I don't know if it's necessary
to specifically allow XHTML documents via application/xhtml+xml ?

- 3.2.5. Image, near the start says "A photo has the following
properties: " and references "photo" in a few other places which
causes confusion since the next section is specifically for Photo
objects

- "time and date the photo was taken" is listed under Image, but then
is explicitly listed as difference for Photo

- the "player applet" property of Video and Audio objects seems a bit
ambiguous, is there a real-world example of this?

- if there are any optional properties for objects they should be
indicated (seems like quite a few could potentially be optional)

- is there a suggested method for creating unique identifiers for
objects? For Person it'd be neat if it was something like md5(email)
(if known)*

- 5.1.1. Song says 'The "tv episode" Object type represents a song or
a recording of a song. ' -- tv episode?

- The "title" property of Song also says "The title of the movie."


I'm pretty excited about where all of this is going, even if I'm
normally just lurking, keep it up all!

Cheers,
Beau


* Disclosure: I work for Automattic, owners of Gravatar, so an md5 of
emails would allow us to use that to infer a Gravatar URL, but I still
think it's a handy unique identifier ;)

Monica Keller

unread,
Aug 15, 2009, 8:47:50 PM8/15/09
to activity...@googlegroups.com
Hi Beau thanks for looking at the spec in detail ! Below are some
responses we just updated it too btw

On Sat, Aug 15, 2009 at 3:42 PM, Beau Lebens<beau....@gmail.com> wrote:
>
> Hi All,
>
> It's quite possible that I'm repeating previous comments or am
> off-mark in some other way, but I was tinkering about today and read
> through http://martin.atkins.me.uk/specs/activitystreams/activityschema
> and wanted to post up some comments/suggestions/fixes for the
> document, in case anyone finds them useful:
>
> - there are some missing references to what element should be used
> (and the specific details of that element) for certain pieces of data,
> e.g. Article > summary
That should be an excerpt of the article. Probably the first
paragraph. But doesn't have to be. Used to interest the reader to
click the link to the full article. We can add it to the spec


> - Many mime types reference text/html, I don't know if it's necessary
> to specifically allow XHTML documents via application/xhtml+xml ?



>
> - 3.2.5.  Image, near the start says "A photo has the following
> properties: " and references "photo" in a few other places which
> causes confusion since the next section is specifically for Photo
> objects
>
> - "time and date the photo was taken" is listed under Image, but then
> is explicitly listed as difference for Photo
>
> - the "player applet" property of Video and Audio objects seems a bit
> ambiguous, is there a real-world example of this?
>
> - if there are any optional properties for objects they should be
> indicated (seems like quite a few could potentially be optional)
>
> - is there a suggested method for creating unique identifiers for
> objects? For Person it'd be neat if it was something like md5(email)
> (if known)*
>
We removed image. Good point on player-applet no real implementations
yet so we should remove it from our implementors draft 1. All of the
elements which extend atom are optional. As far as creating
identifiers we used tags which concatenated our company web site and
our internal ids and object type but the big point is that these are
really not unique. For people encrypted email addresses or links to
their profile page would be great so you can correlate across networks

> - 5.1.1.  Song says 'The "tv episode" Object type represents a song or
> a recording of a song. ' -- tv episode?
>
> - The "title" property of Song also says "The title of the movie."
>
Good catch Martin is going to fix that. Thanks

Monica Keller

unread,
Aug 15, 2009, 8:49:26 PM8/15/09
to activity...@googlegroups.com
Sorry forgot to say that for
> - Many mime types reference text/html, I don't know if it's necessary
> to specifically allow XHTML documents via application/xhtml+xml ?

This should be covered by the atom spec. Thanks

Max Wegmueller

unread,
Aug 17, 2009, 7:24:26 AM8/17/09
to Activity Streams
An other feedback on "negative" events.

How can following user activities be expressed:
- stop sharing a file for a user group
- deleting a file
- removing a tag on a file

Should for this be used a verb like:
http://activitystrea.ms/schema/1.0/delete

or are there other ways for doing this?

Regards,
Max

Chris Messina

unread,
Aug 23, 2009, 10:47:54 PM8/23/09
to activity...@googlegroups.com
So far we haven't looked at negative activities because we haven't documented real world examples where feeds contain this information.

If you wanted to document real world examples of feeds containing such things on the wiki, that'd be great and the first step to supporting them.

Chris
--
Chris Messina
Open Web Advocate

Personal: http://factoryjoe.com
Follow me on Twitter: http://twitter.com/chrismessina

Citizen Agency: http://citizenagency.com
Diso Project: http://diso-project.org
OpenID Foundation: http://openid.net

This email is:   [ ] bloggable    [X] ask first   [ ] private

Peter Gmail

unread,
Aug 24, 2009, 3:05:15 AM8/24/09
to activity...@googlegroups.com
Chris -
I just requested access to the wiki to document  our examples for  Community Equity 

We already started the mapping on our wiki : 

Peter

Reiser 2.0

unread,
Sep 7, 2009, 11:27:44 AM9/7/09
to Activity Streams
We have added two use cases for delete see
http://activitystreams.pbworks.com/Delete-activity-example
I believe with Activity Streams there is great potential to create
new social mash services (e.g social value evaluation, search engine
integration, aggregation of users contributions/credentials across
multiple platform etc.) versus just a simple aggregated activity
feed of a person.


On Aug 24, 4:47 am, Chris Messina <chris.mess...@gmail.com> wrote:
> So far we haven't looked at negative activities because we haven't
> documented real world examples where feeds contain this information.
> If you wanted to document real world examples of feeds containing such
> things on the wiki, that'd be great and the first step to supporting them.
>
> Chris
>
Reply all
Reply to author
Forward
0 new messages