TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
redoc-cli bundle is the one free alternative I've gotten to work so far.
spotlight.io is great but expensive. This API is maybe 1% of my doc
set so I can't justify spending that much.
On Tue, Apr 10, 2018 at 1:17 AM, Stuart Conner
<stuart2 -at- stuartconner -dot- me -dot- uk> wrote:
> +1 for this; also interested in any answers.
>
> I've been experimenting with the offline Swagger editor and while the
> side-by-side view seems pretty good, generating an output in any form of
> HTML results in a file with lots of problems - sample XML not rendered
> correctly, information missing, ....
>
> Stuart.
>
> ================================
>
> Message: 1
> Date: Mon, 9 Apr 2018 13:05:05 -0700
> From: Robert Lauriston <robert -at- lauriston -dot- com>
> To: TECHWR-L <techwr-l -at- techwr-l -dot- com>
> Subject: Alternatives to swagger-codegen?
> Message-ID:
> <CAN3Yy4B1OOGeJCkw0x_HXx6LrcZ5EqQ53F2YZrC5tOzx6jQ4+g -at- mail -dot- gmail -dot- com>
> Content-Type: text/plain; charset="UTF-8"
>
> I used swagger-codegen -l html2 to generate the first version of an API doc
> from Swagger YAML, but feedback from users is that it's incomplete or
> inaccurate. Has anyone successfully used other tools such as 3scale, Akana,
> Axway, or Gelato?
>
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com
