-----------------------------------------------------------
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
> 
>

Reply via email to