StackShare
May 1, 2019
Needs advice
382k views382k
CommentsApiary vs DocGen
Overview
Share your Stack
Help developers discover the tools you use. Get visibility for your team's tech choices and contribute to the community's knowledge.
CLI (Node.js)
Manual
Advice on Apiary, DocGen
Detailed Comparison
It takes more than a simple HTML page to thrill your API users. The right tools take weeks of development. Weeks that apiary.io saves. | DocGen is a command-line documentation tool for software products. It takes plain text or CommonMark (Markdown) as input, and generates both a static website and a PDF copy. |
Documentation- Organized around resources, code samples with syntax highlight, easy to explore.;Inspector- Users can make API calls through apiary.io, we show them how they differ from documentation.;Community- Opensource your API documentation on GitHub. The right channel between developers on both side of the API.;Always Tested [closed alpha]- The documentation is always watching your real API and tells you whenever it gets out of sync.;Server Mock- The fastest way to static API prototype—just ‘document’ your future API and it’s up. 2 minutes to Hello World.;GitHub Integration- Store the API Blueprint in your repository, everything gets updated as soon as you commit a new version.;I/O Validation- Add a JSON Schema to the API Blueprint and the proxy will help your API users understand implementation of data structures better.;Customization [closed alpha]- The documentation and tools can be seamlessly placed on your website and gray-labeled so the friction is close to none. | - |
Statistics | |
GitHub Stars - | GitHub Stars 50 |
GitHub Forks - | GitHub Forks 15 |
Stacks 241 | Stacks 15 |
Followers 325 | Followers 26 |
Votes 109 | Votes 0 |
Pros & Cons | |
Pros
| No community feedback yet |
Integrations | |
What are some alternatives to Apiary, DocGen?
Postman
It is the only complete API development environment, used by nearly five million developers and more than 100,000 companies worldwide.
Jekyll
Think of Jekyll as a file-based CMS, without all the complexity. Jekyll takes your content, renders Markdown and Liquid templates, and spits out a complete, static website ready to be served by Apache, Nginx or another web server. Jekyll is the engine behind GitHub Pages, which you can use to host sites right from your GitHub repositories.
Swagger UI
Swagger UI is a dependency-free collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation and sandbox from a Swagger-compliant API
Hugo
Hugo is a static site generator written in Go. It is optimized for speed, easy use and configurability. Hugo takes a directory with content and templates and renders them into a full html website. Hugo makes use of markdown files with front matter for meta data.
Gatsby
Gatsby lets you build blazing fast sites with your data, whatever the source. Liberate your sites from legacy CMSs and fly into the future.
Hexo
Hexo is a fast, simple and powerful blog framework. It parses your posts with Markdown or other render engine and generates static files with the beautiful theme. All of these just take seconds.
ReadMe.io
It is an easy-to-use tool to help you build out documentation! Each documentation site that you publish is a project where there is space for documentation, interactive API reference guides, a changelog, and much more.
Middleman
Middleman is a command-line tool for creating static websites using all the shortcuts and tools of the modern web development environment.
Gridsome
Build websites using latest web tech tools that developers love - Vue.js, GraphQL and Webpack. Get hot-reloading and all the power of Node.js. Gridsome makes building websites fun again.
Docusaurus
Docusaurus is a project for easily building, deploying, and maintaining open source project websites.
