ReadMe

vs

Swagger

ReadTheDocs is a huge resource that millions of developers rely on for software documentation. With ReadtheDocs it simple to create documentation for your development project that will be hosted free, forever. ReadTheDocs integrates with your favorite version control system, be it Git, Mercurial, Bazaar, or Subversion. Allowing you to push documentation along with project updates through your CI/CD pipeline.

MkDocs is a fast, simple and open-source static site generator that's geared towards building project documentation for software projects. With MkDocs it's easy to setup documentation with source files that are written in Markdown, and configured with a single YAML configuration file. When it is time to host your documentation, MkDocs builds completely static HTML sites for GitHub pages, Amazon S3 or a hosting provider of your choice.

SkyDocs is a lightweight static documentation builder with MarkDown.

Docusaurus makes it easy to maintain open source documentation websites. With Docusaurus you can wriet docummentation and blog posts using Markdown and save time when doing so. Docusaurs automatically publish your files as static html files ready to serve on the web.

With Insomnia you can design, debug and deploy APIs. Insomnia is free API design platform and REST Client developed for macOS, Linux and Window. The application makes it easy to create and group requests, specify environment variables, authentication and generate code snippets. You can also get all the details on responses. View the whole request timeline, status codes, body, headers, cookies and much more. The software also makes it easy to orginize your projects with workspaces, folders, environments, drag-and-drop requests, and easily import and export your data. Insomnia integrates with API gateways such as the Kong API Gateway, and Kong for Kubernetes. While Insomnia comes with a free-forever license, the software provides premium monthly subscriptions for E2EE data sync and advanced collaboration features.