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