RE: Update API document

Hi. Thierry.

> -----Original Message-----
> From: Thierry MICHEL [mailto:tmichel@w3.org]
> Sent: Thursday, March 04, 2010 4:18 PM
> To: 이원석
> Cc: Chris.Poppe@UGent.be; Felix Sasaki; Bailer, Werner; public-media-
> annotation@w3.org
> Subject: Re: Update API document
> 
> 
> Wonsuk,
> 
> Thanks for your update. The API document is now ready for publication on
> TR space (it will now occur next tuesday).
> http://www.w3.org/2008/WebVideo/Annotations/drafts/API10/WD_V2/Overview.ht
> ml
> 
> just a small remark for
> 2.3.6.2 TargetAudience
> 
> in the example
> should
> [http://www.fosi.org/icra,"no nudity", "Age Group"]
> 
> not be
> ["http://www.fosi.org/icra","no nudity", "Age Group"]

Right. It's done.

Thanks.

Best regards,
Wonsuk

> Thierry.
> 
> 
> 이원석 wrote:
> > Hi. Thierry.
> > I also updated the API
> doc(http://www.w3.org/2008/WebVideo/Annotations/drafts/API10/WD_V2/Overvie
> w.html) directly with my new jigedit password.
> >
> > Best regards,
> > Wonsuk.
> >
> >> -----Original Message-----
> >> From: public-media-annotation-request@w3.org [mailto:public-media-
> >> annotation-request@w3.org] On Behalf Of 이원석
> >> Sent: Thursday, March 04, 2010 11:13 AM
> >> To: tmichel@w3.org
> >> Cc: Chris.Poppe@UGent.be; Felix Sasaki; Bailer, Werner; public-media-
> >> annotation@w3.org
> >> Subject: RE: Update API document
> >>
> >> Hi. Thierry.
> >> I fixed bugs. Please find the enclosed file.
> >>
> >> Best regards,
> >> Wonsuk.
> >>
> >>> -----Original Message-----
> >>> From: Thierry MICHEL [mailto:tmichel@w3.org]
> >>> Sent: Thursday, March 04, 2010 12:40 AM
> >>> To: Chris.Poppe@UGent.be
> >>> Cc: 'Felix Sasaki'; 'Bailer, Werner'; 이원석; public-media-
> >>> annotation@w3.org
> >>> Subject: Re: Update API document
> >>>
> >>>
> >>> Chris,
> >>>
> >>> I have copied the API document to
> >>> http://www.w3.org/2008/WebVideo/Annotations/drafts/API10/WD_V2/Overvie
> >>> w.ht
> >>> ml
> >>>
> >>> The document does not validate HTML.
> >>> http://validator.w3.org/check?uri=http://www.w3.org/2008/WebVideo/Anno
> >>> tati
> >>> ons/drafts/API10/WD_V2/Overview.html
> >>>
> >>> Also there is a broken link
> >>>
> >>> Line: 648 ftp://ftp.isi.edu/in-notes/bcp/bcp47.txt
> >>>
> >>>
> >>> Please fix these two issues ASAP as I can not publish the document as
> is.
> >>>
> >>>
> >>> On my side I have updated the Status of this document section and
> >>> header section to conform to the publication rules.
> >>>
> >>> Thanks,
> >>>
> >>> Thierry.
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>>
> >>> Poppe wrote:
> >>>> Dear all,
> >>>>
> >>>>
> >>>>
> >>>> I have updated the API document according to the remarks of Werner
> >>>> (except for the list of possible values remark).
> >>>>
> >>>>
> >>>>
> >>>> @Felix,
> >>>>
> >>>> I guess the request could look something like this (I have no idea
> >>>> about the proper syntax so it’s just to give you an idea):
> >>>>
> >>>> Request:
> >>>> http://example.com/my-media-resource/getProperty?ma-name=x&?ma-
> >>> source=y&?ma-subtype=z&?ma-language=s&?ma-fragment=t
> >>>>
> >>>>
> >>>> Not sure how to denote that these are optional parameters, or what
> >>>> the JSON format is to return the list of MAObjects that correspond
> >>>> to the request. I am sure you can come up with a good solution.
> >>>>
> >>>>
> >>>>
> >>>> Kind regard,
> >>>>
> >>>> Chris
> >>>>
> >>>>
> >>>>
> >>>> *From:* public-media-annotation-request@w3.org
> >>>> [mailto:public-media-annotation-request@w3.org] *On Behalf Of *Felix
> >>> Sasaki
> >>>> *Sent:* maandag 1 maart 2010 20:35
> >>>> *To:* Bailer, Werner
> >>>> *Cc:* ???; Chris.Poppe@ugent.be; public-media-annotation@w3.org
> >>>> *Subject:* Re: Update API document
> >>>>
> >>>>
> >>>>
> >>>> Hello Werner, Chris, all,
> >>>>
> >>>> I agree with your comments, esp. the non-alignment between the Web
> >>>> Service Usage and the API. I am happy to change the Web Service
> >>>> usage and implement other comments in this thread, but it would be
> >>>> great to have an example for one property how the web service
> >>>> request should look like.
> >>>>
> >>>> Many thanks in advance & best,
> >>>>
> >>>> Felix
> >>>>
> >>>> 2010/3/1 Bailer, Werner <werner.bailer@joanneum.at
> >>>> <mailto:werner.bailer@joanneum.at>>
> >>>>
> >>>> Dear all,
> >>>>
> >>>>
> >>>>
> >>>> I think the API document has progressed a lot. I have the following
> >>>> remarks (in addition to Chris’):
> >>>>
> >>>>
> >>>>
> >>>> - the first editorial note in section 2 can be removed, this is IMO
> >>>> now
> >>> done
> >>>> - the second editorial note (SET functionality) could be turned into
> >>>> text explaining the reasons for not including set functionality now.
> >>>> Even if we decide to add it, it is unlikely to be mandatory for an
> >>>> implementation.
> >>>>
> >>>> - the editorial note in the first sentence of “Web service” in 2.1
> >>>> can be removed, this is done with the Felix definitions
> >>>>
> >>>> - the image file for the figure in section 2.1 seems not to be at
> >>>> the right place, also I suggest to use a PNG instead of a JPEG for a
> >>>> figure like this
> >>>>
> >>>> - section 2.1 as the text references “scenario x” it might be useful
> >>>> to add “scenario x: …” to the headings user agent and web service
> >>>>
> >>>> - if I saw that correctly, all return types inherit (at least) from
> >>>> MAObject - should get Property return MAObject[] instead of object[] ?
> >>>>
> >>>> - 2.3.1.1 what is EASN? Was this meant to say ISAN?
> >>>>
> >>>> - 2.3.1.1 wrong indentation of the attribute of the Identifier
> >>>> interface
> >>>>
> >>>> - 2.3.1.3 the example for language should not say N/A
> >>>>
> >>>> - 2.3.2.4 <http://2.3.2.4>: typos: “altitudee” and “altitiude”
> >>>> (seems someone doesn’t like this word ;-)
> >>>>
> >>>> - lists of possible value: this is quite inconsistent now, e.g. a
> >>>> list of values for ma:contributor, but not for ma:creator; for some
> >>>> it seems to make sense to put them directly into the document (e.g.
> >>>> types of policy, and possibly relation), but for those where there
> >>>> can be many values (genre, creator, contributor) we should reference
> >>>> a vocabulary we consider best practice
> >>>>
> >>>>
> >>>>
> >>>> Best regards,
> >>>>
> >>>> Werner
> >>>>
> >>>>
> >>>>
> >>>> *From:* public-media-annotation-request@w3.org
> >>>> <mailto:public-media-annotation-request@w3.org>
> >>>> [mailto:public-media-annotation-request@w3.org
> >>>> <mailto:public-media-annotation-request@w3.org>] *On Behalf Of *???
> >>>> *Sent:* Samstag, 27. Februar 2010 16:03
> >>>> *To:* Felix Sasaki; Chris.Poppe@ugent.be
> >>>> <mailto:Chris.Poppe@ugent.be>
> >>>>
> >>>>
> >>>> *Cc:* public-media-annotation@w3.org <mailto:public-media-
> >>> annotation@w3.org>
> >>>> *Subject:* RE: Update API document
> >>>>
> >>>>
> >>>>
> >>>> Hi. Felix, Chris and all.
> >>>>
> >>>> Most of all, thanks for Felix and Chris’s revision.
> >>>>
> >>>> I updated the API doc with Felix’s file. In addition I commit two
> >>>> files(XML and HTML) from Felix to the CVS repository. Because I
> >>>> guess Thierry is on the trip at this moment ;)
> >>>>
> >>>> So you can take a look at the last version of API doc via below link.
> >>>>
> >>>> http://dev.w3.org/2008/video/mediaann/mediaont-api-1.0/mediaont-api-
> >>> 1.0.html
> >>>>
> >>>>
> >>>> Best regards,
> >>>>
> >>>> Wonsuk.
> >>>>
> >>>>
> >>>>
> >>>> *From:* public-media-annotation-request@w3.org
> >>>> <mailto:public-media-annotation-request@w3.org>
> >>>> [mailto:public-media-annotation-request@w3.org
> >>>> <mailto:public-media-annotation-request@w3.org>] *On Behalf Of
> >>>> *Felix
> >>> Sasaki
> >>>> *Sent:* Friday, February 26, 2010 9:20 PM
> >>>> *To:* Chris.Poppe@ugent.be <mailto:Chris.Poppe@ugent.be>
> >>>> *Cc:* public-media-annotation@w3.org <mailto:public-media-
> >>> annotation@w3.org>
> >>>> *Subject:* Re: Update API document
> >>>>
> >>>>
> >>>>
> >>>> Hi Chris, all,
> >>>>
> >>>> 2010/2/25 Chris Poppe <chris.poppe@ugent.be
> >>> <mailto:chris.poppe@ugent.be>>
> >>>> Now I really changed the subject of the mail so that people are not
> >>>> confused.
> >>>>
> >>>> Kind regards,
> >>>> Chris
> >>>> --
> >>>> Ghent University - Multimedia Lab
> >>>> Sint-Pietersnieuwstraat 41
> >>>> B-9000 Ghent, Belgium
> >>>>
> >>>> tel: +32 9 264 89 17
> >>>> fax: +32 9 264 35 94
> >>>> e-mail: Chris.Poppe@ugent.be <mailto:Chris.Poppe@ugent.be>
> >>>>
> >>>> URL: http://multimedialab.elis.ugent.be
> >>>>
> >>>>
> >>>>
> >>>>
> >>>> ---------- Weitergeleitete Nachricht ----------
> >>>> From: "Chris Poppe" <chris.poppe@ugent.be
> >>>> <mailto:chris.poppe@ugent.be>>
> >>>> To: "public-media-annotation@w3.org
> >>>> <mailto:public-media-annotation@w3.org>"
> >>>> <public-media-annotation@w3.org
> >>>> <mailto:public-media-annotation@w3.org>>
> >>>> Date: Thu, 25 Feb 2010 08:25:40 +0100
> >>>> Subject: RE: Updated ontology doc within Seoul F2F meeting Dear all,
> >>>>
> >>>> please find attached an updated version of the API document (both
> >>>> xml file and html file) (I am having troubles to upload this).
> >>>>
> >>>> Felix, after you add your updates could you please upload this?
> >>>>
> >>>>
> >>>>
> >>>>
> >>>> I made the updates, but unfortunately I am also currently not able
> >>>> to commit to CVS. Thierry, could you do that? See
> >>>>
> >>>> http://fabday.fh-potsdam.de/~sasaki/mawg/ma-api-doc-20100226.zip
> >>>> <http://fabday.fh-potsdam.de/%7Esasaki/mawg/ma-api-doc-20100226.zip>
> >>>>
> >>>> The ZIP-File contains an HTML-version of the draft, the XML-source,
> >>>> and a diff between Chris' version and mine, to show you my edits. If
> >>>> there are further comments today, I can make another editing round
> >> tonight.
> >>>> Btw., I changed some of the non-webservice examples, since the
> >>>> output seemed inconsistent, e.g. the writing conventions for
> >>>> DOMString result types are not always the same. Also a question:
> >>>> should we have one convention for properties names with multiple
> >>>> words, e.g. "named fragments"? I would propose to use small caps and
> a
> >> hyphen always, e.g.
> >>>> "named-fragments". What do people think?
> >>>>
> >>>> Best,
> >>>>
> >>>> Felix
> >>>>
> >>>>
> >>>>
> >>>>
> >>>>     Current changes:
> >>>>     added subtypes/roles
> >>>>     added information on the use of the API (two use case scenarios)
> >>>>     created new interface to hold language attribute.
> >>>>     created new interface to hold uri, sourceformat,
> fragmentidentifier
> >>>>     and mappingtype
> >>>>     Updated the document with information on how to use the subtypes
> >>>>
> >>>>
> >>>>     Kind regards,
> >>>>     Chris
> >>>>
> >>>>     --
> >>>>     Ghent University - Multimedia Lab
> >>>>     Sint-Pietersnieuwstraat 41
> >>>>     B-9000 Ghent, Belgium
> >>>>
> >>>>     tel: +32 9 264 89 17
> >>>>     fax: +32 9 264 35 94
> >>>>     e-mail: Chris.Poppe@ugent.be <mailto:Chris.Poppe@ugent.be>
> >>>>
> >>>>     URL: http://multimedialab.elis.ugent.be
> >>>>
> >>>>
> >>>>
> >>>>
> >>>>
> >

Received on Thursday, 4 March 2010 07:38:53 UTC