Size: a a a

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

2021 February 08

NV

Nick Volynkin in DocOps-сообщество
Появилось
https://chaos.band
источник

NV

Nick Volynkin in DocOps-сообщество
Это прекрасный сайт, на котором иногда появляются новые статьи
источник

NV

Nick Volynkin in DocOps-сообщество
Но тут шутка оказалась смешной и понятной только в моей голове
источник

rd

rus dacent in DocOps-сообщество
Картинки топовые =)
источник
2021 February 10

KC

Kseniya Chudakova in DocOps-сообщество
Всем привет! Расскажите, как вы автоматизируете документацию по базам данных. Интересны все кейсы, даже самые банальные.

Например, знаю, что многие выгружают описание сущностей-атрибутов в доку. Какие кейсы вам встречались? Что было удобно?
источник

NV

Nick Volynkin in DocOps-сообщество
Kseniya Chudakova
Всем привет! Расскажите, как вы автоматизируете документацию по базам данных. Интересны все кейсы, даже самые банальные.

Например, знаю, что многие выгружают описание сущностей-атрибутов в доку. Какие кейсы вам встречались? Что было удобно?
По своей конкретной БД или по СУДБ как продукту?
источник

KC

Kseniya Chudakova in DocOps-сообщество
Nick Volynkin
По своей конкретной БД или по СУДБ как продукту?
На самом деле, и там и там)
источник

NV

Nick Volynkin in DocOps-сообщество
Про документирование своей конкретной мне когда-то рассказывал Николай @NortaBirdo. Раз в полгода тут задают такой вопрос и я всегда его вспоминаю :)
источник

KC

Kseniya Chudakova in DocOps-сообщество
Nick Volynkin
Про документирование своей конкретной мне когда-то рассказывал Николай @NortaBirdo. Раз в полгода тут задают такой вопрос и я всегда его вспоминаю :)
Спасибо за наводку:) Жажда до реальных кейсов.

Я поищу ещё в записях с Гипербатона, кажется, что-то было. Если что, поделюсь.
источник

Н

Николай in DocOps-сообщество
Kseniya Chudakova
Всем привет! Расскажите, как вы автоматизируете документацию по базам данных. Интересны все кейсы, даже самые банальные.

Например, знаю, что многие выгружают описание сущностей-атрибутов в доку. Какие кейсы вам встречались? Что было удобно?
если прям супер коротко. Цель: документация для DWH (т.е. интересуют источники, алгоритмы загрузки и итоговые схемы). Средства: питон (н-ое количество скриптов которые парсят метасхемы и конвертят их в описания), sphinx, plantuml. Бек для сфинкса на ноде.
источник

Н

Николай in DocOps-сообщество
ETL пишется ручками на rst. ив месте со всеми скриптами и сетингами лежит в гите.
источник

KC

Kseniya Chudakova in DocOps-сообщество
Николай
если прям супер коротко. Цель: документация для DWH (т.е. интересуют источники, алгоритмы загрузки и итоговые схемы). Средства: питон (н-ое количество скриптов которые парсят метасхемы и конвертят их в описания), sphinx, plantuml. Бек для сфинкса на ноде.
У меня как раз история с DWH
источник

Н

Николай in DocOps-сообщество
В самом приятном случае (например добавили табличку 1-1) апдейт доки получается одной строкой консоли.
источник

Н

Николай in DocOps-сообщество
В чуть менее приятном приходится еще руками подпилить ETL. Но схемы все схемы-переходы-списки таблиц полей и т.п. все равно автоматика собирает.
источник

Н

Николай in DocOps-сообщество
Бизнесовые подписи к полям-таблицам девелопер делает в доп.атрибутах (метаинформация) прямо в DWH. Скрипты их читают.
источник

Н

Николай in DocOps-сообщество
Ну и некоторое количество хуков которые отрабатывают на тех.поля (например версионирование везде делается одинаково - на это есть одна статья)
источник

Н

Николай in DocOps-сообщество
кажется пора это уже выложить куда-то)
источник

KC

Kseniya Chudakova in DocOps-сообщество
Николай
кажется пора это уже выложить куда-то)
это и правда очень ценная и редкая информация 👍
с удовольствием послушала бы или почитала
источник

KC

Kseniya Chudakova in DocOps-сообщество
Спасибо!
источник

Н

Николай in DocOps-сообщество
@Nick_Volynkin а куда подобное можно засунуть?
источник