Re: V2 REST Api documentation (first-cut)

2017-03-01 Thread David Radley
the best, David. From: Apoorv Naik To: "dev@atlas.incubator.apache.org" Date: 22/02/2017 19:10 Subject: Re: V2 REST Api documentation (first-cut) Thanks for your detailed review David. 1. I see that there’s some inconsistency in the Javadocs for EntityREST fi

Re: V2 REST Api documentation (first-cut)

2017-02-22 Thread Apoorv Naik
alphabetically but the XML one is not. >>- AtlasConstraintDef does not document the possible values for the >>constraints and their usage. >> >> >>If this is the type of observations you are looking for - I am willing to >>spend more time reviewing the AP

Re: V2 REST Api documentation (first-cut)

2017-02-22 Thread Apoorv Naik
ML one is not. >- AtlasConstraintDef does not document the possible values for the >constraints and their usage. > > >If this is the type of observations you are looking for - I am willing to >spend more time reviewing the API, > all the best, David. > > > &g

Re: V2 REST Api documentation (first-cut)

2017-02-21 Thread David Radley
r.apache.org Date: 20/02/2017 06:12 Subject: Re: V2 REST Api documentation (first-cut) Hi Apoorv, API Doc is very simplified and UI is also looks good and clear. It will be really helpful to developers. Integration with swagger <http://swagger.io> in API documentation is awesome. Tha

Re: V2 REST Api documentation (first-cut)

2017-02-21 Thread Ernie Ostic
Thank you! The interactive interface is an excellent way of documenting the APIs and providing an easy-to-manage interface for prototyping, testing, and learning the behavior of the APIs, not to mention easy exploration of all possible "types"! We have done this with many of our own proprietar

Re: V2 REST Api documentation (first-cut)

2017-02-19 Thread Keval Bhatt
Hi Apoorv, API Doc is very simplified and UI is also looks good and clear. It will be really helpful to developers. Integration with swagger in API documentation is awesome. Thanks, Keval On Sat, Feb 18, 2017 at 9:07 AM, Apoorv Naik wrote: > Hi Atlas community, > > The REST