Size: a a a

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

2020 November 05

ML

Maksim Lapshin in DocOps-сообщество
Dmitry Gurkalov
Сколько лет после этого код проработал в продакшене? Как часто вносились изменения?
Какое-то время до и после меня, суммарно наверное лет 10.

Не могу сказать, что это был жизненно необходимый вариант, но когда пишешь на плюсах, кодогенерация стабов очень удобна
источник

ML

Maksim Lapshin in DocOps-сообщество
Изменения примерно раз в 2-3 недели. Бизнес устоявшийся, изменений мало, делать их боялись, да и жутко неудобно это было с rational rose
источник

ML

Maksim Lapshin in DocOps-сообщество
вопрос по неймингу.

Есть система, у неё есть состояния, между ними переходы по событиям.

Выглядит, что именам состояний хочется подобрать ing  (Connecting, Running, Failing), а имена событий как ed:  Initialized, Connected ...

Насколько это совпадает с практикой?  Вразнобой уже пробовали — фигня получается =)
источник

M

Max in DocOps-сообщество
Maksim Lapshin
вопрос по неймингу.

Есть система, у неё есть состояния, между ними переходы по событиям.

Выглядит, что именам состояний хочется подобрать ing  (Connecting, Running, Failing), а имена событий как ed:  Initialized, Connected ...

Насколько это совпадает с практикой?  Вразнобой уже пробовали — фигня получается =)
А тот, кто будет это читать, точно не будет путать Running и Connected? На мой взгляд, Connected звучит больше как состояние, чем как событие.
источник

IC

Ivan Cheban in DocOps-сообщество
Maksim Lapshin
вопрос по неймингу.

Есть система, у неё есть состояния, между ними переходы по событиям.

Выглядит, что именам состояний хочется подобрать ing  (Connecting, Running, Failing), а имена событий как ed:  Initialized, Connected ...

Насколько это совпадает с практикой?  Вразнобой уже пробовали — фигня получается =)
Нужно создать naming convention и следовать этим правилам. Вот советы от Гугла, как лучше именовать:
https://cloud.google.com/apis/design/naming_convention
источник

ML

Maksim Lapshin in DocOps-сообщество
Ivan Cheban
Нужно создать naming convention и следовать этим правилам. Вот советы от Гугла, как лучше именовать:
https://cloud.google.com/apis/design/naming_convention
Спасибо
источник

HH

Houston Heat in DocOps-сообщество
Maksim Lapshin
> генерить код по спеке все еще в стадии отрицания

зря =) В 2005-м я пилил код на C++, который генерировался из Corba IDL (предтеча протобуфа и gRPC)
У Clojure библиотека для Redis вполне успешно генерит себе command API из json, который предоставляет сам redis, живут вроде не первый год и не жалуются
https://github.com/ptaoussanis/carmine#documentation-and-command-coverage (ref: L96)

так что от стадии отрицания можно отойти
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Ещё есть такой класс решений - по спеке поднимать отдельный сервис, абстрагируясь от того что там внутри (кодген, что-то динамическое, шаманство и т.д.)
https://www.graphile.org/postgraphile/
источник

DG

Dmitry Gurkalov in DocOps-сообщество
Houston Heat
У Clojure библиотека для Redis вполне успешно генерит себе command API из json, который предоставляет сам redis, живут вроде не первый год и не жалуются
https://github.com/ptaoussanis/carmine#documentation-and-command-coverage (ref: L96)

так что от стадии отрицания можно отойти
Если бы все было так просто. Тут больше помогут наверное истории своего свежего успеха с примерами. В идеале на php или go - так понятнее в детали вникнуть.
Или прям удачные опенсорс примеры на этом стеке. Хочется именно детали посмотреть и нюансы. Потому как на других языках это будет просто: нуда, наверное это работает.
источник

DG

Dmitry Gurkalov in DocOps-сообщество
Может быть есть книжка какая. Чистая архитектура к примеру мне сразу зашла. Хотя наверняка есть куча успешных продуктов, где в центре всего лежит фреймворк.
Или статья какая хорошая.
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
Houston Heat
У Clojure библиотека для Redis вполне успешно генерит себе command API из json, который предоставляет сам redis, живут вроде не первый год и не жалуются
https://github.com/ptaoussanis/carmine#documentation-and-command-coverage (ref: L96)

так что от стадии отрицания можно отойти
так это кложа :), у лиспов с DSL и кодогенерацией традиционно всё хорошо
источник
2020 November 07

СФ

Семён Факторович... in DocOps-сообщество
Привет всем новым участникам!

Пожалуйста, расскажите, откуда вы узнали о чате и какие вопросы хотели бы обсудить?
источник

d

dn.khelilov in DocOps-сообщество
Из соседнего чата cio
Хотелось бы увидеть какие-то готовые кейсы про документацию, как она должна выглядеть, обязательные составляющие и тд. И очень хотелось бы сразу инструментарий увидеть
источник
2020 November 08

К

Константин in DocOps-сообщество
Мы ищем пути минимизации расходов на поддержание доков по архитектуре в актуальном состоянии, а также инструменты по быстрому построению разных представлений модели инфопотоков - табличный каталог с фильтрами, компонентные диаграммы, детали структуры конкретного dto.
источник

К

Константин in DocOps-сообщество
Узнал из канала https://t.me/it_arch вроде...
источник
2020 November 09

L

Lana in DocOps-сообщество
внезапно обнаружилось вот такое https://www.propeldocs.com читала-читала а потом внезапно осознала, что это вообще систему управления правовой документацией и никак с нашим docops не связано (EDMS). Разочарование, я уже подумала, кто-то упаковал в сервис это все)
источник

СФ

Семён Факторович... in DocOps-сообщество
месяц назад собеседовал техписателя, который пришел в профессию из юриспруденции (больше 10 лет был юристом)

в общем, он там во всех своих судебных документах вовсю использовал RST, генерацию docx, реюз контента и автообновляемые ссылки между разделами. Сам пилил фильтры в Pandoc и экстеншены к нему через python-docx
источник

ДС

Денис Старков... in DocOps-сообщество
Семён Факторович
месяц назад собеседовал техписателя, который пришел в профессию из юриспруденции (больше 10 лет был юристом)

в общем, он там во всех своих судебных документах вовсю использовал RST, генерацию docx, реюз контента и автообновляемые ссылки между разделами. Сам пилил фильтры в Pandoc и экстеншены к нему через python-docx
судя по описанию, сегодня был на собесе у меня
источник

IC

Ivan Cheban in DocOps-сообщество
Lana
внезапно обнаружилось вот такое https://www.propeldocs.com читала-читала а потом внезапно осознала, что это вообще систему управления правовой документацией и никак с нашим docops не связано (EDMS). Разочарование, я уже подумала, кто-то упаковал в сервис это все)
Как он грузится медленно. Повеяло шарпойнтом.
источник

СФ

Семён Факторович... in DocOps-сообщество
Денис Старков
судя по описанию, сегодня был на собесе у меня
крутой же чувак?
источник