Y
кто-то знает, что такое семантика с большим шагом?
Size: a a a
2017 December 04
ŹR
Кто-нибудь знает аналог swagger но для websocket api?
ZK
Народ, вы чат точно правильно выбрали?
AP
Для websocket API нет сымсла в Swagger - это же не REST, который а) описан и более-менее единообразен, б) пригоден для дёргания из доки (я про исполняемые примеры)
AP
WebSocket - это socket. Шлёт байтики. Никто же не хочет swagger для TCP-сокетов, не говоря о UDP :)
AP
кто-то знает, что такое семантика с большим шагом?
а вот тут ЯННП
ŹR
WebSocket - это socket. Шлёт байтики. Никто же не хочет swagger для TCP-сокетов, не говоря о UDP :)
Ну вот я там Json передаю
ŹR
И хочу это дело как то задокументировать
ŹR
Только красиво и на халяву
AP
Я же говорю: JSON в websocket использует даже не большинство. Да и концепция другая совсем - персистентное соединение вместо отдельных сеансов "вопрос/ответ". И даже если кто-то использует JSON, обычно нет никакого роутинга, а есть что-то вроде pub-sub, т.е. опять таки подход "как у swagger'a" не подходит
AP
Swagger и Blueprint (а также все подобные штуки) основаны на том, что есть "стандарт" для REST - как минимум есть глаголы, заголовки, параметры и пути, т.е. есть база, которую уже можно документировать
ŹR
Мне надо чисто генерация доков
ŹR
Без всяких других фич
AP
Да блин! Не из чего генерить доки - у всех ws по-разному готовятся
ŹR
Но смысл в том, что в ws тоже есть пути
AP
AP
Если они у кого-то есть, это его личное дело
ŹR
Ну крче говоря не знаешь инструмента - так и говори
AP
Ну как же не поспорить то! :)
ŹR
А че тут спорить: я хочу красивую доку получить, а написать минимум текста