[oslc-AssetMgmt] Specification finalization

Wed Apr 11 17:42:04 EDT 2012

Hi Steve

Thanks for the feedback.  We discussed some of these during our last OSLC meeting, but for the benefit of others on this list here the responses.

Introduction: 
The introduction has been updated with an expanded definition of an asset and additional examples.
http://open-services.net/bin/view/Main/AssetMgSpecificationV2?sortcol=table;up=#Introduction

Namespaces: 
References to the asset namespace URL are now links

Labels and Relationships:
I haven't updated this section of the wiki yet, but I agree with your comments.  It should include UIPreview

Artifact: 
Added 'Artifact Fragment' to the terminology.
http://open-services.net/bin/view/Main/AssetMgSpecificationV2?sortcol=table;table=up#Terminology

Artifact Media:
Added <code> style where needed.
http://open-services.net/bin/view/Main/AssetMgSpecificationV2?sortcol=table;table=up;up=#Artifact_Media

Samples:
Haven't updated this section yet, but again I agree with your comment and will make the change.

Test Suite and Reference Implementation:
We've scheduled a meeting next Wednesday to discuss contributing asset management spec tests to the eclipse lyo project.  We do not have immediate plans for a reference implementation, though a trial of Rational Asset Manager 7.5.1.1 which implements the spec may be downloaded from jazz.net.

Thanks,
Sheehan Anderson
sheehan at us.ibm.com

-----oslc-assetmgmt-bounces at open-services.net wrote: -----
To: oslc-assetmgmt at open-services.net
From: Steve K Speicher/Raleigh/IBM at IBMUS
Sent by: oslc-assetmgmt-bounces at open-services.net
Date: 04/10/2012 10:51AM
Subject: Re: [oslc-AssetMgmt] Specification finalization

Sorry for the delay in in the review.  Overall looks good, not sure that 
any of my comments are urgent other than the definition of "artifact 
fragment"

These comments are on revision 101 last save date of April 10, 2012
http://open-services.net/bin/view/Main/AssetMgSpecificationV2?rev=101

Introduction:

presentations => presentation materials
hardware => construction hardware? computer hardware? both?

Are financial assets covered by this spec? ;-)  Though seriously, since 
homes, buildings, cars are "assets" they intent of this spec is not the 
financial "asset" of stocks and saving accounts.  A common problem when we 
use general words, just an observation not sure worth of correction. 
Perhaps only making the definition and examples a bit more clear would 
help.

"Assets should referenced" =>
"Assets should be referenced" 

Namespaces:

I recommend making http://open-services.net/ns/asset# a link, previously 
we didn't do this since we didn't have vocabulary documents.  It would be 
good to pull in the vocabulary documents somehow.

Labels for Relationships:
Seems to almost match 
http://open-services.net/pipermail/oslc-cm_open-services.net/2012-February/000351.html 
, reason to leave out UIPreview?

Artifact:
Term "fragment" is introduced and a bit unclear to me why this terminology 
is used and not "Artifact resource".  Perhaps it would be good to add this 
term "Artifact fragment" to the glossary of terms.

Artifact Media:
Style comment, would expect "oslc_assets:content", "oslc_asset.name", etc 
to be in <code></code> like format.

These comments is on 
http://open-services.net/bin/view/Main/AssetMgSpecificationV2Samples

(I realize this isn't done in other places) the HTTP VERB lines contain 
the full URL, to be HTTP "correct", I would suggest making it more valid 
by changing:
GET http://example.com/assets/cat
   to
GET /assets/cat HTTP/1.1
Host: example.com

I recommend also attaching the example documents to the wiki page if 
possible.

Test Suite & Reference Implementation:
Are these available?  If not, when does the WG plan to provide this?

Thanks,
Steve Speicher | IBM Rational Software | (919) 254-0645

oslc-assetmgmt-bounces at open-services.net wrote on 04/03/2012 05:51:53 PM:

> From: Sheehan Anderson/Durham/IBM at IBMUS
> To: oslc-assetmgmt at open-services.net, 
> Cc: oslc-core at open-services.net
> Date: 04/03/2012 05:52 PM
> Subject: [oslc-AssetMgmt] Specification finalization
> Sent by: oslc-assetmgmt-bounces at open-services.net
> 
> The OSLC Asset 2.0 specification is ready for finalization as we have 
met 
> our criteria of
> a)  Resolving all outstanding issues that have been reported
> b)  Completion of an implementation of the specification with feedback.
> 
> We plan to finalize the specification in our next meeting on April 10th. 

> The finalization was not completed in our previous meeting as some 
members 
> wanted more time to review the specification and the implementation 
report 
> needed to be completed.  Please take some time to review the following 
links
> and report any issues on the wiki (
http://open-services.net/bin/view/Main/
> AssetMgSpecificationV2Issues) or the OSLC Asset mailing list.
> 
> Specification
> http://open-services.net/bin/view/Main/AssetMgSpecificationV2
> 
> Samples
> http://open-services.net/bin/view/Main/AssetMgSpecificationV2Samples
> 
> Implementation Report / Implementation
> http://open-services.net/bin/view/Main/AssetImplementationReports
> https://jazz.net/wiki/bin/view/Main/RamV2RestApiMain
> https://jazz.net/downloads/rational-asset-manager/releases/7.5.1.1
> 
> Vocabulary
> http://open-services.net/bin/view/Main/AssetVocabulary
> 
> Thanks,
> Sheehan Anderson
> sheehan at us.ibm.com_______________________________________________
> Oslc-AssetMgmt mailing list
> Oslc-AssetMgmt at open-services.net
> 
http://open-services.net/mailman/listinfo/oslc-assetmgmt_open-services.net

_______________________________________________
Oslc-AssetMgmt mailing list
Oslc-AssetMgmt at open-services.net
http://open-services.net/mailman/listinfo/oslc-assetmgmt_open-services.net

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://open-services.net/pipermail/oslc-assetmgmt_open-services.net/attachments/20120411/6a211a1a/attachment-0003.html>