Re: Update API document

2010/3/4 이원석 <wslee@etri.re.kr>

> Hi. Thierry.
>
>
> > -----Original Message-----
> > From: Thierry MICHEL [mailto:tmichel@w3.org]
> > Sent: Thursday, March 04, 2010 5:44 PM
> > To: 이원석
> > Cc: Chris.Poppe@UGent.be; Felix Sasaki; Bailer, Werner; public-media-
> > annotation@w3.org
> > Subject: Re: Update API document
> >
> >
> > OK so you are done with all the cotation issue ?
> >
> > can I freezethe document ?
>
> Yes. I think so :)
>


+1. I will make the changes to the API "service" calls after the
publication, i.e. to the XML source.

Best,

Felix


>
> Best regards,
> Wonsuk.
>
> > Thierry.
> >
> > 이원석 wrote:
> > > It's done :)
> > >
> > > Best regards,
> > > Wonsuk.
> > >
> > >> -----Original Message-----
> > >> From: Thierry MICHEL [mailto:tmichel@w3.org]
> > >> Sent: Thursday, March 04, 2010 4:51 PM
> > >> To: tmichel@w3.org
> > >> Cc: 이원석; Chris.Poppe@UGent.be; Felix Sasaki; Bailer, Werner; public-
> > >> media-annotation@w3.org
> > >> Subject: Re: Update API document
> > >>
> > >>
> > >>
> > >> And probably these also need cotation:
> > >>
> > >> [http://individuals.example.com/Contributor1, "editor"],
> > >> [http://individuals.example.com/Contributor2, "producer"]
> > >> [2009-06-26T15:30:00]
> > >> ["San Jose", 37.33986481118008, -121.88507080078125, 0, "GPS"]
> > >> ["http://individuals.example.com/ChrisPoppe", 10.0, 0, 10.0,
> "Personal
> > >> Rating"]
> > >> [3.072, 2.304]
> > >> [3600]
> > >> etc.
> > >>
> > >> Thierry MICHEL wrote:
> > >>> Wonsuk,
> > >>>  I guess the following also needs the same update.
> > >>>
> > >>> Response (JSON format): "targetaudience" :
> > [http://www.fosi.org/icra,"no
> > >>> nudity", "Age Group"]
> > >>>
> > >>> Thierry.
> > >>>
> > >>> 이원석 wrote:
> > >>>> 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>
> > >>>>>>>>> <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
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>>
> > >
>