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 / about 1 month ago

Often used for cases where a project exposes a REST or other type of API service. Open API is a popular method of documenting such API services. It can also be used along side tools such as Swagger Codegen to produce boilerplate code for API interaction / testing purposes. There may also be support files for popular API testing tools such as Postman or Insomnia. This makes it easier at a glance to see what data is... - Source: dev.to / 5 months ago

Regarding the IO, there could also be low-code tools. Swagger could be taken as inspiration. Swagger codegen is a great tool that allows you to declaratively produce code to interact with APIs. - Source: dev.to / 11 months ago

Personally I would try to put as much business logic as possible into your API that runs on server. Use a format like swaggger (https://swagger.io/tools/swagger-codegen/) to auto generate the client SDKs for every platform you support. Source: 12 months ago

It sounds like you want an OpenAPI spec. This can be written by hand or partially generated using a crate like utoipia. Once you have an OpenAPI spec you can generate clients in a myriad of languages using the (swagger codgen)[https://swagger.io/tools/swagger-codegen/] tools. Source: about 1 year ago

Https://github.com/slatedocs/slate this ! Big company use it ( stripe etc ). Source: over 1 year ago

The second most common question being "What framework does Stripe use to build their documentation?" and the answer has unfortunately always been "They use a custom setup they built themselves and isn't available." － so then Slate gets brought up as a suitable replacement. Source: about 2 years ago

DocuAPI is a multilingual API documentation theme for Hugo created and maintained by Bjørn Erik Pedersen, the lead maintainer and co-creator of Hugo itself. It’s built on top of the Slate API docs generator, which itself was inspired by Stripe’s and PayPal’s API docs. The JavaScript section of DocuAPI has been rewritten from Jquery to AlpineJS.​​​​​​. - Source: dev.to / about 2 years ago

I've used Slate to document APIs which similarly will produce a local website. You can host that privately or there's built in support to push to github pages if you're hosting it in a github repo. The documentation itself is all written in markdown and managed separate from your API code. Source: about 2 years ago

We used to use Slate - https://github.com/slatedocs/slate for our APIs in my previous job. That was pretty neat. - Source: Hacker News / over 2 years ago