Swagger UI VS Antora

Swagger UI Reviews

Antora Reviews

Swagger UI mentions (44)

• Let's write a simple microservice in Clojure

  Swagger descriptor for REST API with nice Swagger UI console. Nowadays, it is a standard de facto. Microservices should be accessible via HTTP and operate with data in a human-readable JSON format. As a bonus, it is super easy to generate data types and API client code for the client side (it works well for a TypeScript-based front-end, for example). - Source: dev.to / 9 days ago

• What is API Discovery, and How to Use it to Reduce Your Attack Surface

  Configure Swagger UI or a similar tool for automated scanning and documentation of your network's APIs. Here's a basic example of how to set up a Swagger configuration file (swagger-config.yaml) for API documentation:. - Source: dev.to / about 2 months ago

• Fun with Avatars: Crafting the core engine | Part. 1

  API Documentation: FastAPI generates interactive documentation with Swagger UI and ReDoc, making exploring and understanding API endpoints effortless. - Source: dev.to / 4 months ago

• Building Fast APIs with FastAPI: A Comprehensive Guide

  Visit http://127.0.0.1:8000 in your browser or a tool like Swagger UI to explore the automatically generated API documentation. - Source: dev.to / 4 months ago

• Effortless API Documentation: Accelerating Development with FastAPI, Swagger, and ReDoc

  Swagger UI allows developers to explore and test API endpoints interactively. It displays detailed information about each endpoint, including parameters, request/response models, and example requests. - Source: dev.to / 4 months ago

Antora mentions (21)

• I don't always use LaTeX, but when I do, I compile to HTML (2013)

  You have also AsciiDoctor ( https://asciidoctor.org/ ) which is alive and well. I am using it for technical CS documentation internally, but only for single page documents. I did not try to deploy their whole multi-document setup called Antora ( https://antora.org/ ). - Source: Hacker News / 3 months ago

• Quarkus : Greener, Better, Faster, Stronger

  Well scaffolding an extension also generates a docs module wich leverages Antora, and with a minimal effort, we can produce a nice and clean documentation. - Source: dev.to / 7 months ago

• Docs as Code at Linode (2020)

  AsciiDoc has a bit more features compared to Markdown which allows for a richer presentation of the docs. Biggest difference is that Linode has the docs in a separate repository. Not sure if it is a limitation of their toolchain or a deliberate decision. Antora allows you to have the project documentation in the actual project repositories. It then pulls the docs from all the different repos together to build the... - Source: Hacker News / 10 months ago

• Ideas on improving internal technical documentation`

  I've been pushing for Antora everywhere I go. It allows you to keep text-based (AsciiDoc, similar to markdown but an actual standard) documentation with your repositories and from that build a central documentation portal site. Source: about 1 year ago

• I wish Asciidoc was more popular

  We use AsciiDoc for our technical documentation, and it's great. Last year we moved from AsciiDoctor to Antora [1] and I can't recommend it enough. [1] https://antora.org/. - Source: Hacker News / about 1 year ago