A
A
Alexander Zubarev2018-10-15 15:15:35
API
Alexander Zubarev, 2018-10-15 15:15:35

What is better apiDoc or swagger?

There is a project in php, and the api of this project is not documented in any way.
I searched and immediately found two solutions:
- Swagger
- apiDoc
As I understand they have the same essence, documentation is built on the basis of annotations.
Tried to figure out the pros and cons.
- Swagger seemed more flexible to me, you can generate a dock right on the fly, but the annotations are too voluminous and clutter up the code.
- apiDoc less flexible, but more human-readable annotations.
Who used to paint the pros and cons, or maybe there is another solution?

Answer the question

In order to leave comments, you need to log in

1 answer(s)
D
Dimonchik, 2018-10-15
@zualex

swagger users have 20+ times more apidok, look at apidok as your custom solution, and swagger as a prom standard

Didn't find what you were looking for?

Ask your question

Ask a Question

731 491 924 answers to any question