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 [email protected] wrote on 04/03/2012 05:51:53 PM: > From: Sheehan Anderson/Durham/IBM@IBMUS > To: [email protected], > Cc: [email protected] > Date: 04/03/2012 05:52 PM > Subject: [oslc-AssetMgmt] Specification finalization > Sent by: [email protected] > > 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 > [email protected]_______________________________________________ > Oslc-AssetMgmt mailing list > [email protected] > http://open-services.net/mailman/listinfo/oslc-assetmgmt_open-services.net
