Size: a a a

DocOps-сообщество

2018 October 22

АГ

Андрей 🦀PAK3APYKY✋ Гаврилов in DocOps-сообщество
Vadim Smelyanskiy
Если говорить о DocOps, это может быть не совсем простой текст, а с читаемой человеком строгой семантикой

Моя мечта – генерировать из тест-кейсов на Gherkin'е 🙂
Тут есть ещё один важный момент. DocOps и хранение документов в git подразумевает использование инструментариев git для работы с версиями. А там все сравнения файлов делаются на уровне строк. Соответстветственно форматы типа PlantUML, MarkDown или AsciiDoc обрабатываются хорошо, а всякие XML - плохо.
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Андрей 🦀PAK3APYKY✋ Гаврилов
Тут есть ещё один важный момент. DocOps и хранение документов в git подразумевает использование инструментариев git для работы с версиями. А там все сравнения файлов делаются на уровне строк. Соответстветственно форматы типа PlantUML, MarkDown или AsciiDoc обрабатываются хорошо, а всякие XML - плохо.
Это да, XML для Balsamiq в данном случае должен быть только как промежуточный этап

Потому Gherkin и хотелось бы как исходник.
По пути наименьшего сопротивления, можно YAML попробовать
источник

СФ

Семён Факторович in DocOps-сообщество
Vadim Smelyanskiy
Ещё у Balsamiq есть CLI, так что при желании за несколько дней можно сотворить что-нибудь в духе препроцессора для Foliant'а

Из текста в какие-нибудь шаблоны Balsamiq -> отдать на CLI -> вернуть PNG и вставить в страницу
Вот это круто
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Семён Факторович
Вот это круто
Может быть, соберём требования и в open-source пойдём пилить?)

Если интересно, можно начать в личке, а потом сюда вернуться
источник

СФ

Семён Факторович in DocOps-сообщество
не-не, я просто восхищение выразил:)
источник

СФ

Семён Факторович in DocOps-сообщество
поучаствовать не готов
источник

АГ

Андрей 🦀PAK3APYKY✋ Гаврилов in DocOps-сообщество
Vadim Smelyanskiy
Может быть, соберём требования и в open-source пойдём пилить?)

Если интересно, можно начать в личке, а потом сюда вернуться
Я как-то порывался начать пилить в опенсорс тулзы для докопса. Всё закончилось на том, что я старый и я хочу жрать и семья хочет жрать, а опенсорс - он немного не про "жрать".
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Я тут подумал

У меня в работе пару задач такой инструмент решит, так что могу для себя считать, что оно про "жрать" 🙃

Кто 27ого в Новосибирске на митапе будет, кто готов обсудить требования очно?)
Сама разработка не проблема, просто хочется сразу учесть опыт коллег из разных областей
источник

АГ

Андрей 🦀PAK3APYKY✋ Гаврилов in DocOps-сообщество
Vadim Smelyanskiy
Я тут подумал

У меня в работе пару задач такой инструмент решит, так что могу для себя считать, что оно про "жрать" 🙃

Кто 27ого в Новосибирске на митапе будет, кто готов обсудить требования очно?)
Сама разработка не проблема, просто хочется сразу учесть опыт коллег из разных областей
Я буду на митапе. Готов обсудить, но сам участвовать пока не очень готов - в процессе смены работы, предвижу изрядную загруженность погружением в новые задачи...
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Уже круто)
Я к митапу исходные требования оформлю, пообщаемся, на следующей неделе может ещё кто из чата добавит от себя что-нибудь, в ноябре сяду делать
источник

АГ

Андрей 🦀PAK3APYKY✋ Гаврилов in DocOps-сообщество
Ага
источник

PA

Pavel Alferov in DocOps-сообщество
Vadim Smelyanskiy
Уже круто)
Я к митапу исходные требования оформлю, пообщаемся, на следующей неделе может ещё кто из чата добавит от себя что-нибудь, в ноябре сяду делать
Я на митапе не буду, но готов поучаствовать в обсуждении дистанционно
источник

ИЦ

Игорь Цупко in DocOps-сообщество
Игорь Цупко
Коллеги, вот есть PlantUml, которая позволяет блок-схемы рисовать as a code.
А есть что-то аналогичное для рисования мокапов as a code? Чтобы набросать простейший текстик, а оно выдало картиночку с интерфейсом
пришла в голову мысль: а может быть есть генераторы публички из swagger-формата?
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Pavel Alferov
Я на митапе не буду, но готов поучаствовать в обсуждении дистанционно
29ого опубликую драфт спецификации, можно будет в отдельный чат в Телеграме собраться
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Игорь Цупко
пришла в голову мысль: а может быть есть генераторы публички из swagger-формата?
Что имеется в виду под публичкой?
Если публичная страница с API, то сам Swagger UI или Slate, если конвертнуть

https://github.com/lord/slate
источник

ИЦ

Игорь Цупко in DocOps-сообщество
Vadim Smelyanskiy
Что имеется в виду под публичкой?
Если публичная страница с API, то сам Swagger UI или Slate, если конвертнуть

https://github.com/lord/slate
frontend приложение с формочками для работы с апи.
источник

I

Igor in DocOps-сообщество
Игорь Цупко
frontend приложение с формочками для работы с апи.
Так оно же так сёрвит это, а если заданы примеры запроса то и формат предложит
источник

ИЦ

Игорь Цупко in DocOps-сообщество
Igor
Так оно же так сёрвит это, а если заданы примеры запроса то и формат предложит
не понял, что вы имеете ввиду
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Игорь Цупко
не понял, что вы имеете ввиду
Swagger UI из коробки генерирует кнопку Try it out на каждом запросе, как раз формы с параметрами и ответ сервера выводится

Демо:
https://petstore.swagger.io/#/pet/addPet
источник

ИЦ

Игорь Цупко in DocOps-сообщество
Vadim Smelyanskiy
Swagger UI из коробки генерирует кнопку Try it out на каждом запросе, как раз формы с параметрами и ответ сервера выводится

Демо:
https://petstore.swagger.io/#/pet/addPet
отлично. А можно такое же, но чтобы вместо ввода json была форма с полями? :)
источник