Doxygen vs Swagger2Markup
Doxygen
doxygen.nlSwagger2Markup
github.comSide by side
| Figure | Doxygen | Swagger2Markup |
|---|---|---|
| Price from | Free | — |
| Free plan | Yes | — |
| Free trial | — | — |
| Open source | — | — |
| Windows | Yes | — |
| macOS | Yes | — |
| Linux | Yes | Yes |
| API | — | Yes |
| Self-hosted | — | Yes |
| Plans published | 1 | 0 |
| Spec score · API Documentation Tools | 8.0 (#9) | 7.0 (#27) |
| Configuration | Doxygen provides more than 100 configurable options for fine-tuning output. | Options include output markup language, output language, path grouping, generated examples, and document ordering. |
| License | Doxygen is licensed under the GNU General Public License and is provided without express or implied warranty. | The project is licensed under Apache License 2.0. |
| Output formats | Doxygen generates HTML, PDF via LaTeX, Word via RTF and XML documentation. | It converts Swagger JSON or YAML into AsciiDoc, GitHub Flavored Markdown, or Atlassian Confluence Wiki documents. |
| Purpose | Doxygen is a documentation generator that creates documentation from source-code comments and parses classes, functions and variables. | Swagger2Markup combines handwritten material with automatically generated API documentation to produce an up-to-date REST API guide. |
| Support | Users are directed to Stack Overflow and the doxygen users mailing list, while commercial feature or bug-fix support has limited capacity. | The project README directs questions to Gitter and asks users to report bugs and enhancement requests through GitHub issues and pull requests. |
Plans
In their own words
Doxygen
Doxygen is a free documentation generator that turns source-code comments into reference material, parsing items such as classes, functions and variables. It supports C/C++, Lex, Java, Python, VHDL, PHP IDL, C#, Fortran, Objective-C 2.0 and some D sources. Output can be generated as HTML, PDF through LaTeX, Word through RTF or structured XML for external tools. Graphviz’s dot tool can add include-dependency, collaboration, call, directory-structure and class-hierarchy diagrams. Doxywizard provides a graphical interface for editing settings and running the generator on Windows, Linux and macOS; Doxygen also works on many Unix flavors. It supports HTML Help, docsets, Qt-Help and Eclipse Help, with more than 100 configurable options. The tool runs without registration and does not collect personal or usage data. It is self-hosted and licensed under the GNU General Public License, without express or implied warranty. Help is listed through Stack Overflow and the doxygen users mailing list; commercial feature and bug-fix support has limited capacity.
Swagger2Markup
Swagger2Markup has no write-up on Specifiction yet; its figures are above.