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 ;)