AY
смотря какого API, для Lua APi мы юзаем LuaDoc, а для рест HTTP Апи - сваггер
А RAML не пробовали?
Size: a a a
2017 March 29
NV
Сваггер
L
А RAML не пробовали?
нет, сваггер как-то показался проще и его гораздо больше используют и как-то легко так лег на процесс разработки
L
у нас нет никаких сложных иерархических метаконструкций, поэтому сваггер справляется отлично. выглядит стильно-модно-молодежно, клиенту удобно вроде
NV
Лана а вы код для сваггера руками редактируете или генерите из исходников проекта?
L
в коде прямо пишут девелоперы, а я за ними прохожу и поправляю
NV
наверное, это лучший способ )
ND
А как вы думаете, а может и знаете. Как крупные компании справляются с изменением контента на сайте? Например, поменялось название продукта. Как поменять его на всем сайте, не просматривать же все страницы
ND
?
AY
NASTYA Dm
А как вы думаете, а может и знаете. Как крупные компании справляются с изменением контента на сайте? Например, поменялось название продукта. Как поменять его на всем сайте, не просматривать же все страницы
Массовая замена и пересборка
ND
это с помощью чего обычно делается?
ND
какойто утилиты может?
AY
NASTYA Dm
это с помощью чего обычно делается?
У вас сайт на основе CMS?
ND
ага
AY
NASTYA Dm
ага
Тогда с ходу не отвечу
ND
ну явно же не просматривают все страницы
NV
Храните такие вещи в переменных и шаблонизируйте исходники
NV
Jekyll, например
AY
Храните такие вещи в переменных и шаблонизируйте исходники
+1.
NV
Сайт с документацией на CMS? Почему такой выбор?