(In the interests of addressing the interested audiences, what I'm doing
here is addressing Dare's comments about activity streams over on the
activity streams mailing list, and the media extensions over here.)
My feedback to Dare about the activity stuff can be viewed here:
http://groups.google.com/group/activity-streams/msg/27d35bbb13281640
Dare Obasanjo wrote:
1.) http://martin.atkins.me.uk/specs/atommedia
- This spec describes a bunch of elements but not how they are
supposed to be used. I'm especially confused about atom:link with
> rel="preview". What is it a preview of? The example in the spec
> has a single preview (pic) and two enclosures (also pictures).
> How is that expected to be treated? I'd expect there to be a
1:1 mapping between enclosures and previews but there doesn't
> seem to be any such rule in the spec.
The text of the spec here is:
The "preview" link relation indicates that the link is to a
reduced-fidelity and/or reduced-content representation of the media
object that is intended to allow the user to sample the content
before retrieving a full representation.
From your mention of multiple enclosures I think the confusion arises
because AtomMedia specifically addresses only the use-case where an
entry represents one specific media object -- that is, one photo, or one
video, etc -- so all enclosures and all previews are of that same object.
Specifically, if there are multiple enclosures they are expected to be
different representations of the same content.
So "the media object", as referred to in the description of
rel="preview", means the single photo, video or other media object that
this entry represents.
The spec then goes on to give some concrete examples:
For example, if the media object is an image a thumbnail of the
photograph can be linked using this relationship.
If the media object is a video, the preview could be a thumbnail
image of a representative frame from the video, or a clip showing a
short segment of the full video.
Would clarifying the fact that a particular entry represents only one
media object address your concern, or are the above quoted passages
themselves unclear?
Thanks for the feedback.
-Martin
