W3C home > Mailing lists > Public > public-media-annotation@w3.org > March 2010

RE: Update API document

From: 이원석 <wslee@etri.re.kr>
Date: Thu, 4 Mar 2010 11:41:48 +0900
Message-ID: <B4EAD1122C31304099A5CDEA5447210F01E16800@email2>
To: <tmichel@w3.org>
Cc: <Chris.Poppe@UGent.be>, "Felix Sasaki" <felix.sasaki@fh-potsdam.de>, "Bailer, Werner" <werner.bailer@joanneum.at>, <public-media-annotation@w3.org>
Hi. Thierry.
I also updated the API doc(http://www.w3.org/2008/WebVideo/Annotations/drafts/API10/WD_V2/Overview.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 02:42:21 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 4 March 2010 02:42:22 GMT