> Would clarifying the fact that a particular entry represents only one media > object address your concern, or are the above quoted passages themselves > unclear?
Making that constraint explicit up front would address the concern. -- THINGS TO DO IF I BECOME AN EVIL OVERLORD #139 If I'm sitting in my camp, hear a twig snap, start to investigate, then encounter a small woodland creature, I will send out some scouts anyway just to be on the safe side. (If they disappear into the foliage, I will not send out another patrol; I will break out the napalm.) -----Original Message----- From: [email protected] [mailto:[email protected]] On Behalf Of Martin Atkins Sent: Sunday, January 11, 2009 12:56 PM To: Atom Syntax Subject: Re: Some Draft Atom-related Specs for Activity Streams (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
