LI
если какой-то saas с продуктом api-as-a-service, то еще стоит смотреть на публикацию на RapidAPI - https://rapidapi.com/products/hub/
Size: a a a
2021 September 06
ИМ
блин я сейчас начал набирать, пока фокус был в жире и у меня открылся экран который я в жизни не видел, красивое
ИМ
какой-то прикольный канбан
VS
это наверно борда
VS
/secure/ManageRapidViews.jspa
ИМ
перекрестил и закрыл)
RK
для своего SaaS SDK. Сейчас у нас часть документации в гите, часть в ноушене, часть в гугл доке. Хотим все в одно место переместить, чтоб разрабротчикам чуть удобнее было
RK
это что-то похожее на Zapier? мне же больше цмска нужна
VS
если у вас есть разрабы и уже в гите есть дока, но условный сваггер вам не нравится.
То может присмотреть статик генератор какой-нить?
staticgen.com
То может присмотреть статик генератор какой-нить?
staticgen.com
LI
нет, это маркетплейс, с которым интегрируется сервис предоставляющий api, с одной стороны он решает задачу биллинга и аккаунтинга api вызовов, с другой стороны там можно хостить документацию, плюс дополнительный канал, по которому клиенты будут находить сервис
RK
я пока слабо понимаю, но еще поизучаю их, спасибо!
ИМ
если это техническая документация я бы все таки ее наверное держал ближе к коду и генерировал безо всяких там cms
RK
он, получается, из любой пыли развернет красивый сайт? наверное тоже не совсем то, ведь нужна админка
VS
да никто в админку не будет ходить, инфа сотка
RK
Генерить да, конечно. Но ее ведь можно красиво упаковать и положить на сайт рядом с бизнесовой документацией! ровно как у страйпа. Я так это вижу
LI
readme.io это по сути способ отрисовать swagger и добавить общие комменты, swagger генерится из кода
ИМ
я это понимаю)
ИМ
тут скорее вопрос в том чтоб подзаставить разрабов ее писать
VS
у вас какой стек?
ИМ
https://petstore.swagger.io/ а вот это вот красиво?)