| WS Basic Profile RFC (Version 1.0)
This document is a "Request for Comment" (RFC) for the Proposed Recommendation "IVOA Web Services Basic Profile V1.0". The latest version of the specification (20-10-2010) can be found at:
http://www.ivoa.net/Documents/WSBasicProfile/20101020/
IVOA Review Period: 24 Mar 2010 - 28 Apr 2010
TCG Review Period: 25 Oct 2010 - 25 Nov 2010
This specification presents the IVOA position and interpretation of third-party industry standards (WS-I) relating to SOAP-based web services. In this respect, it is a complement to the IVOA Recommendation "IVOA Single-Sign-On Profile" which describes the IVOA standpoint on third-party industry security practices. Given the nature of the specification, there are no specific reference implementations, although any IVOA SOAP-based web service could be regarded as one, e.g. any of the VOSpace 1.0 or 1.1 reference implementations.
In order to add a comment to the document, please edit this page and add your comment to the list below in the format used for the example (include your WikiName so that authors can contact you for further information). When the author(s) of the document have considered the comment, they will provide a response after the comment.
Additional discussion about any of the comments or responses can be conducted on the GWS WG mailing list, grid@ivoa.net. However, please be sure to enter your initial comments here for full consideration in any future revisions of this document
Comments from the community during the RFC period
These comments are based on the 20100226 version:
General comment: It is very odd looking to have reference citations like this [#] in section headings. It would make more sense to move them to the first point in the main body where the reference is cited, typically in the first sentence of the relevant section.
ok i agree, i have deleted the citations in the titles (response by AndreSchaaff)
Preface materials
Change "Conformance related definitions" to "Conformance-Related Definitions"
ok, done (response by AndreSchaaff)
Section 2, the opening paragraphs, prior to Section 2.1, would fit better in the general introduction, Section 1. Otherwise one encounters "WS-I" in the title to Section 2, and only later do you find out what it means.
ok, no problem to put it in the introduction part (response by AndreSchaaff)
Section 2, 2nd paragraph, "non-property" should be "non-proprietary"
ok, it is changed (response by AndreSchaaff)
Section 2.1, the second remark "Concerning the Discovery topic.." seems like it should be resolved here. In any case, "undergoing" should be "ongoing".
What is "NOTE HERE" supposed to mean?
it is linked to your previous remark, the second remark and "NOT HERE" has to be deleted both (response by AndreSchaaff)
Section 2.2, change the comma to a semicolon after "at the same level"
The last sentence about RFC 2119 etc. is redundant with the previous section on Conformance-Related Definitions.
ok it is done (response by AndreSchaaff)
Section 3, change "+" symbols to words, "and the" or "with the addition of", etc.
ok it is done (response by AndreSchaaff)
Section 4, what is "This"? I think what is meant is "The WS-I Attachment Profile..."
ok i replace This by the full sentence (response by AndreSchaaff)
Sentence "It was decided at IVOA Kyoto..." is conversational and does not belong in the standard. Just say "This standard does not define an attachment profile."
ok (response by AndreSchaaff)
Section 6 -- so what is the point here? This section should be rewritten, removing the casual language and being specific. It is not important that something was shown at Pune in 2004, but rather what has been demonstrated or not and what is the recommendation.
Section 7 -- again, what is the point? What is the recommendation?
ok, section 6 and 7 will be rewritten (response by AndreSchaaff)
Section 8.1 is essentially self-referential and not helpful.
ok (response by AndreSchaaff)
There is no need for a Section 8.2.1, it being the only topic in 8.2. The last sentence is redundant with Section 4.
ok (response by AndreSchaaff)
Are these rules ones being defined here, or references to rules in the various WS-I documents?
There is no need for a Section 8.3.1, it being the only topic in 8.3. In R0131, "turning" should be "returning".
ok (response by AndreSchaaff)
Section 9 seems at least partly redundant with Section 6, and the sentence "A guide about...could be provided if needed." is not very helpful!
ok, sentence about guideline is removed (response by AndreSchaaff)
I do not understand what is meant in 9.1 Use Cases. How is this helpful? Is Use Cases supposed to be Section 9.2, and Assertion Definition.. supposed to be 9.3? If not, there is no need for a Section 9.1.
it is not possible to provide generic use cases to test the services, so each service provider has to create use cases to test his services (unit tests) (response by AndreSchaaff)
Section 10 -- wording is too casual. "The conformance could be claimed..." Could? Is? And later, "...could be useful..." Would it be useful or not?
ok changed to "is" (response by AndreSchaaff)
Section 11 -- the change log is ambiguous. What does it mean to "take into account"? What rules were removed? To what version are these changes related?
ok it will be argumented (response by AndreSchaaff)
Rather than repeating text from RFC 2119 in Appendix A, deleted the Appendix and put in an actual citation of RFC 2119.
ok (response by AndreSchaaff)
--
All of these comments have been attended to in the latest version.
-- MatthewGraham - 20Oct2010
Comments from TCG during TCG Review (25 Oct 2010 to 25 Nov 2010)
Applications (Tom McGlynn, Mark Taylor)
Approved. TomMcGlynn 2010-11-29
Data Access Layer (Patrick Dowler, Mike Fitzpatrick)
Approved.
-- PatrickDowler - 2010-11-23
Data Model (Mireille Louys, JesusSalgado)
Approved.
-- MireilleLouys- 2010-12-01
Grid&Web Sevices (Matthew Graham, Paul Harrison)
I approve this most excellent document.
-- MatthewGraham - 29 Nov 2010
Registry (Ray Plante, Gretchen Greene)
I approve this document.
-- GretchenGreene - 3 Dec 2010
Semantics (Sebastien Derriere, Norman Gray)
Approved.
-- SebastienDerriere - 03 Dec 2010
VOEvent (Rob Seaman, Roy Williams)
Approved.
-- RobSeaman - 2010-11-29
Standard and Processes (Francoise Genova)
I approve the document. I have a few late (sorry) minor comments /typos. Some of them may be wrong since I am not a native English speaker.
- p.2, Conformance-related definition, second paragraph, last sentence:
The IVO application is an application > An IVO application is... (?)
- p.5, Section 1.3, second paragraph, last sentence: actual
- p.5, Section 2.1: in the Security item, add a "," between confidentiality and authentication
- p.6, Section 2.3, last sentence of the first paragraph: I have the impression that the sentence mixes the authors' evaluation of the MIME solution (too restrictive) and a fact coming from WS-I themselves, that they do not make mandatory to associate this profile with the WS-I Basic Profile 1.1. I may be wrong but some clarification would help the reader to understand where the two ideas come from.
- p.8, R0121: The interface for returning table metadata (?)
Francoise, 30 November 2010
Data Curation & Preservation (Alberto Accommazzi)
KDD (Giuseppe Longo)
Theory (Herve Wozniak, Claudio Gheller)
Approved.
TCG (Christophe Arviset, Severin Gaudet)
Thanks for having included the reference to the IVOA Architecture.
You might want to add its link [12] into the reference section
http://www.ivoa.net/Documents/Notes/IVOAArchitecture/20101123/index.html
One minor comment, for the posterity, the second paragraph of the Acknowledgments section "This work is based on discussions.... September 2006" looks a bit strange. I would propose to drop it.
I approve the document. ChristopheArviset
|