Comments 17
Буквально вчера искал что-то для себя и мне понравился вот этот инструмент apidocjs.com. Умеет генерировать приятную на глаз документацию прямо из комментариев к иходному коду (phpDoc).
+4
Тотально согласен — 2017г и RAML активно развили до версии 1.0
Запрогал авто-генератор для Laravel, с поддержкой JSON API — https://github.com/RJAPI/raml-json-api
(Контрибы и предметная критика приветствуется)
PS Insanity is doing the same thing over and over again, expecting different results. Albert Einstein
По сему коллеги — давайте перестанем «кодить» свои велосипеды и начнем работать с качественными форматами представления входных/выходных данных и их описанием. (нисколько не отменяет попыток изобретать что-нибудь новое, академически весомое)
Запрогал авто-генератор для Laravel, с поддержкой JSON API — https://github.com/RJAPI/raml-json-api
(Контрибы и предметная критика приветствуется)
PS Insanity is doing the same thing over and over again, expecting different results. Albert Einstein
По сему коллеги — давайте перестанем «кодить» свои велосипеды и начнем работать с качественными форматами представления входных/выходных данных и их описанием. (нисколько не отменяет попыток изобретать что-нибудь новое, академически весомое)
0
Вопрос тем, кто использовал Swagger 2.0 и RAML. В чём их принципиальное отличие друг от друга? Какая из спецификаций охватывает большее число возможных кейсов (например, возможность явно указывать протокол)?
+1
Ещё есть jsondoc.org/
0
Впечатляющая подборка. Целых два средства для описания RESTful API!
+23
А можно кратно объяснить что это такое вообще и зачем оно нужно? Есть же ASN1 — стандарт описания интерфейсов с кучей написанных генераторов под какие угодно языки программирования?
+1
А какие вообще стандарты / нотации описания интерфейсов бывают? Для бизнес аналитика, системного аналитика.
+1
Как обычно, в комментариях намного больше интересного, чем в статье.
P.S. Статья не плохая, просто такова специфика Хабра
P.S. Статья не плохая, просто такова специфика Хабра
-1
Ахахах 3 из 3х инструмента - "Access denied in your contry"
0
Sign up to leave a comment.
3 лучших инструмента для описания RESTful API