FW: Work Product abbreviations for WS-BRSP templates -??

Forwarding to you some options about the OASIS identification of the new profile specifications, for which I requested MSWord OASIS templates. TC admins wants us to decide.

 

In short:

 

(a)    Using “long” abbreviations of work titles, such as  “BasicProfile12” instead of BP12? (to avoid trademark potential issues). Fine with me.

(b)   Moving the version ID out of  the abbreviation (instead of BP12 or BasicProfile12,  have: …/BasicProfile/v1.2/… in the file names)? Here I think the v# is very constitutive of the name of the profile itself, and means more than just chronological versioning: BP20 is NOT the next step after BP12, but a different branch.  On the other hand, looks a bit redundant to have “…BasicProfile12/v1.2/ …“

 

Personally I’d tend to say yes to (a) but am reluctant to approve (b).

 

Opinion?

 

-jacques

 

 

From: Paul Knight [mailto:] 
Sent: Tuesday, November 27, 2012 12:52 PM
To: Jacques Durand
Cc: Chet Ensign
Subject: Work Product abbreviations for WS-BRSP templates -??

 

Hi Jacques,

 

We received your four template requests... nice to see the TC getting off to a quick start with the documents!

 

Before producing the templates and setting the pattern for the file names, I'd like to list out the file names which would result from your requests [1] and suggest a couple of alternatives.

 

The proposed Work Product (WP) abbreviations are: BP12, BP20, RSP10, and BSP11.

 

The most noticeable issue is the repetition of the Version numbers in the WP abbreviations and in the actual Version identifier.

Based on your requests, we would have file names like:

 

http://docs.oasis-open.org/ws-brsp/BP12/v1.2/BP12-v1.2-csd01.doc

http://docs.oasis-open.org/ws-brsp/BP20/v2.0/BP20-v2.0-csd01.doc

http://docs.oasis-open.org/ws-brsp/RSP10/v1.0/RSP10-v1.0-csd01.doc

http://docs.oasis-open.org/ws-brsp/BSP11/v1.1/BSP11-v1.1-csd01.doc

 

While these names are "legal", I think they are probably not what the TC members really want... (I did not see any discussion of file names in the TC minutes.)

 

A simple change would be to remove the version from the WP abbreviation and just use the Version identifier, which would give us:

http://docs.oasis-open.org/ws-brsp/BP/v1.2/BP-v1.2-csd01.doc

http://docs.oasis-open.org/ws-brsp/BP/v2.0/BP-v2.0-csd01.doc

http://docs.oasis-open.org/ws-brsp/RSP/v1.0/RSP-v1.0-csd01.doc

http://docs.oasis-open.org/ws-brsp/BSP/v1.1/BSP-v1.1-csd01.doc

 

However, there is another constraint in the Naming Directives [2]:

"Filenames and directory names must not contain the trademarked names of products, companies, or other corporate entities where the mark is not owned by OASIS."

I think this means that "BP" could be a problem.  (I think that RSP and BSP are likely to be trademarked as well.)

 

I wonder, especially since the TC's focus is on maintenance of the WS-I specs, if it wouldn't be better to keep the same filenames (WP abbreviation) as in WS-I?  (The names can be seen by following the links from the "references" at the end of the TC Charter web page [3])

 

The WS-I files use the camel-case names:

BasicProfile

ReliableSecureProfile

BasicSecurityProfile 

 

and the file names would be:

 

http://docs.oasis-open.org/ws-brsp/BasicProfile/v1.2/BasicProfile-v1.2-csd01.doc

http://docs.oasis-open.org/ws-brsp/BasicProfile/v2.0/BasicProfile-v2.0-csd01.doc

http://docs.oasis-open.org/ws-brsp/ReliableSecureProfile/v1.0/ReliableSecureProfile-v1.0-csd01.doc

http://docs.oasis-open.org/ws-brsp/BasicSecurityProfile/v1.1/BasicSecurityProfile-v1.1-csd01.doc

 

These look great to me, although somewhat long...

 

Please let me know if you want to modify the requested WP abbreviations, and which WP abbreviations you would like to use.

 

Best regards,

Paul

 

P.S. I'll also update the affiliation for one of the Editors (Abbie) to his current company.

 

 

[1] Template requests:

https://tools.oasis-open.org/issues/browse/TCADMIN-1118

https://tools.oasis-open.org/issues/browse/TCADMIN-1119

https://tools.oasis-open.org/issues/browse/TCADMIN-1120

https://tools.oasis-open.org/issues/browse/TCADMIN-1121

[2] Naming Directives:

http://docs.oasis-open.org/specGuidelines/ndr/namingDirectives.html

[3] WS-BRSP charter links:

https://www.oasis-open.org/committees/ws-brsp/charter.php#item-7

 

-- 
Paul Knight  - Tel: +1 781-861-1013
OASIS - Advancing open standards for the information society
Document Process Analyst