[oslc-AssetMgmt] Specification finalization

[Steve K Speicher]

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