Re: getting started with Swagger / OpenAPI for REST APIs

[Moshe Kruger <moshe -dot- kruger -at- gmail -dot- com>]

Have you looked into Apiary (owned now by Oracle) - a tool for creating,
documenting and trying out Swagger-conformant APIs?

apiary.io

On Dec 7, 2017 20:20, "Elisa R. Sawyer" <elisawyer -at- gmail -dot- com> wrote:

> Thanks, Julie! I agree with you!
>
> On Fri, Dec 1, 2017 at 11:21 AM, Julie Stickler <jstickler -at- gmail -dot- com>
> wrote:
>
> > I'm a visual learner, and the API Handyman's visual documentation was
> just
> > the BEST THING I found when I was trying to teach myself Swagger.
> >
> > http://openapi-specification-visual-documentation.apihandyman.io/
> >
> > On Fri, Dec 1, 2017 at 2:11 PM, Robert Lauriston <robert -at- lauriston -dot- com>
> > wrote:
> >
> > > I finally persuaded my developers to use Swagger, or maybe they came
> > > around to my way of thinking on their own. It's already set up so
> > > after checking out from Git I can run npm install.
> > >
> > > Any suggestions on good docs to help me get up to speed?
> > >
> > > Any tools other than swagger-editor I should check out?
> > > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > > Visit TechWhirl for the latest on content technology, content strategy
> > and
> > > content development | http://techwhirl.com
> > >
> > > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > >
> > > You are currently subscribed to TECHWR-L as jstickler -at- gmail -dot- com -dot- 
> > >
> > > To unsubscribe send a blank email to
> > > techwr-l-leave -at- lists -dot- techwr-l -dot- com
> > >
> > >
> > > Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
> > > http://www.techwhirl.com/email-discussion-groups/ for more resources
> and
> > > info.
> > >
> > > Looking for articles on Technical Communications?  Head over to our
> > online
> > > magazine at http://techwhirl.com
> > >
> > > Looking for the archived Techwr-l email discussions?  Search our public
> > > email archives @ http://techwr-l.com/archives
> > >
> >
> >
> >
> > --
> > Julie Stickler
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > Visit TechWhirl for the latest on content technology, content strategy
> and
> > content development | http://techwhirl.com
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > You are currently subscribed to TECHWR-L as elisawyer -at- gmail -dot- com -dot- 
> >
> > To unsubscribe send a blank email to
> > techwr-l-leave -at- lists -dot- techwr-l -dot- com
> >
> >
> > Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
> > http://www.techwhirl.com/email-discussion-groups/ for more resources and
> > info.
> >
> > Looking for articles on Technical Communications?  Head over to our
> online
> > magazine at http://techwhirl.com
> >
> > Looking for the archived Techwr-l email discussions?  Search our public
> > email archives @ http://techwr-l.com/archives
> >
>
>
>
> --
> Elisa Rood Sawyer
> ~~~~~^~~~~~
> Technical and Creative Writer
> "Apparently there is nothing that cannot happen today." Mark Twain
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | http://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as moshe -dot- kruger -at- gmail -dot- com -dot- 
>
> To unsubscribe send a blank email to
> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
> http://www.techwhirl.com/email-discussion-groups/ for more resources and
> info.
>
> Looking for articles on Technical Communications?  Head over to our online
> magazine at http://techwhirl.com
>
> Looking for the archived Techwr-l email discussions?  Search our public
> email archives @ http://techwr-l.com/archives
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications?  Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions?  Search our public email archives @ http://techwr-l.com/archives