----------------------------------------------------------- This is an automatically generated e-mail. To reply, visit: https://reviews.apache.org/r/61736/#review183222 -----------------------------------------------------------
docs/src/site/twiki/OMAS-Standards.twiki Lines 9 (patched) <https://reviews.apache.org/r/61736/#comment259238> I would not be this blunt. All of the existing applicaiton use the entity API. Instead, I suggest saying something like, " the OMAS APIs are access APIs that are not chatty and should be ideally tailors for consumers to access Atlas. As such we are looking to encourage Atlas application to move away from the lower level APIs and use the OMAS API instead. docs/src/site/twiki/OMAS-Standards.twiki Lines 12 (patched) <https://reviews.apache.org/r/61736/#comment259239> I think you need to explain what OMRS and OMRS connectors are). docs/src/site/twiki/OMAS-Standards.twiki Lines 16 (patched) <https://reviews.apache.org/r/61736/#comment259240> When you say "transforming, mapping data from Atlas/OMRS as required" - I suggest saying the OMAS implmentation will call the lower level resource specific APIs. I suggest not mentioning that the OMAS call Atlas - it calls OMRS which could be Atlas behind it. docs/src/site/twiki/OMAS-Standards.twiki Lines 20 (patched) <https://reviews.apache.org/r/61736/#comment259241> what do you mean by "some duplication is expected"? docs/src/site/twiki/OMAS-Standards.twiki Lines 22 (patched) <https://reviews.apache.org/r/61736/#comment259242> I think of the interface as the API - maybe we should say the implmnetaion of the OMAS interface or something like that. docs/src/site/twiki/OMAS-Standards.twiki Lines 26 (patched) <https://reviews.apache.org/r/61736/#comment259243> You talk of OMAS interfaces and OMAS interface. Is there one or many. Do we require separate OMAS build for each OMAS? docs/src/site/twiki/OMAS-Standards.twiki Lines 42 (patched) <https://reviews.apache.org/r/61736/#comment259245> you refer to the connector OMAS. In this context how would I find that? Do you actually mean the asset OMAS to the connector framework? docs/src/site/twiki/OMAS-Standards.twiki Lines 46 (patched) <https://reviews.apache.org/r/61736/#comment259244> tab docs/src/site/twiki/OMAS-Standards.twiki Lines 50 (patched) <https://reviews.apache.org/r/61736/#comment259246> you mention Atlas here - when it might not be Atlas docs/src/site/twiki/OMAS-Standards.twiki Lines 135 (patched) <https://reviews.apache.org/r/61736/#comment259247> tab docs/src/site/twiki/index.twiki Lines 61 (patched) <https://reviews.apache.org/r/61736/#comment259248> Might be less ambiguous to remove Atlas from the title. - David Radley On Aug. 18, 2017, 2:55 p.m., Nigel Jones wrote: > > ----------------------------------------------------------- > This is an automatically generated e-mail. To reply, visit: > https://reviews.apache.org/r/61736/ > ----------------------------------------------------------- > > (Updated Aug. 18, 2017, 2:55 p.m.) > > > Review request for atlas. > > > Repository: atlas > > > Description > ------- > > ATLAS-2049 Document common standards for OMAS interfaces > > As we start to build OMAS interfaces it seems having some common standards > would be a good idea. I wanted to get this discussion going so opted to > document this in twiki format & submit via review board. The intent isn't > this first pass is correct, but that we come to a consensus ... > > Open to suggestions as to whether this is a useful approach - Alternatives > include > - Simply posting on wiki - but I think we want to keep that for more > consumer style documentation that's been agreed > - Posting as a word doc or similar within the JIRA > > See more info in the JIRA(s) > > -- Nigel. > > > Diffs > ----- > > docs/src/site/twiki/OMAS-Standards.twiki PRE-CREATION > docs/src/site/twiki/index.twiki a8e7de9fb74bca0548eda5f5832e1e2bff3f7aec > > > Diff: https://reviews.apache.org/r/61736/diff/1/ > > > Testing > ------- > > * Rebuilt twiki documentation to validate formatting, and reviewed in Safari. > > > Thanks, > > Nigel Jones > >
