Size: a a a

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

2021 July 29

J

Jonny Cuba in DocOps-сообщество
интересный подход, спасибо!
источник
2021 July 30

VK

Vladimir Khineev in DocOps-сообщество
всем привет!
а у кого нибудь был опыт выстраивания процесса docops в компаниях?
объясню вкратце контекст: приложение состоит из компонентов, условно за каждой компонентой есть проектная команда, у каждой проектной команды постоянный набор док-ов: бизнес требования/спецификации/матрица трассировок требований и тд

Вся документация ведется в вики системе, конфлуэнс, ворд и тд
Как результат - много разрозненной информации в вики, что делает процесс поиска требований довольно громоздким/ не актуальность данных и тд

одна из проектных команд уже начала использовать ascii как основу для docops
Хочу docops привнести на все приложение, как результат в долгосроке - все проекты переедут в docops (идеальное состояние)

С чего можно начать? на что обратить внимание в самом начале пути?  с чего начать выстраивать процесс?
как лучше: создавать отдельный репозиторий под документацию или можно подключиться к кодовому репо?
источник

NV

Nick Volynkin in DocOps-сообщество
Есть такой опыт, ага. Аж канал завёл про это, пока внедрял )
источник

VK

Vladimir Khineev in DocOps-сообщество
😅😆
источник

ML

Maksim Lapshin in DocOps-сообщество
дай ссылку
источник

NV

Nick Volynkin in DocOps-сообщество
источник

rd

rus dacent in DocOps-сообщество
источник

NV

Nick Volynkin in DocOps-сообщество
Там, правда, немного новых постов в последнее время.
источник

IZ

Ivan Z in DocOps-сообщество
Цена ресурса на рынке определяется редкостью

Если ты редкий ресурс, то и зарплата - высокая
источник

ИЦ

Игорь Цупко... in DocOps-сообщество
а если вы очень редкий мудак, а мудаков сейчас никто не ищет? )
источник

ME

Maria Ermakovich in DocOps-сообщество
откопали стюардессу)
источник

IZ

Ivan Z in DocOps-сообщество
Если мудаков никто не ищет, то это не ресурс )
источник

IZ

Ivan Z in DocOps-сообщество
Простите, пятница, был не сдержан ))
источник

F

Fagor in DocOps-сообщество
сами же и ответили, цена определяется спросом, ну и готовностью ответить за спрос, под капотом, а не редкостью. Есть редкоземельные металлы, но почему то золото как бы и выше по спросу, и часто дороже, а если не дороже, то ликвидней, что толку что редкий дорогой, но тот самый неуловимый Джо.
источник

IZ

Ivan Z in DocOps-сообщество
Неуловимый Джо не является ресурсом!

В тезисе цена ресурса определяется редкостью значимо каждое слово )
источник

F

Fagor in DocOps-сообщество
как тезис, несомненно, но вот как гипотеза, не состоятельно🙃 как в принципе и Джо... Хотя, если на Джо как на живца ловить....
источник
2021 August 05

D

Denis in DocOps-сообщество
Коллеги, подскажите, не сталкиваетесь ли вы при создании документации по принципам docs-as-code с такой ситуацией, что из-за использования инклюдов переменных и прочих подобных вещей исходники становится трудно читать? Может быть такое, что в итоге все опять придет к тому, что для ревью доку придется публиковать? Возможно, есть какие-то пути как такого избежать?
источник

ME

Maria Ermakovich in DocOps-сообщество
прикрутить CMS типа Netlify?
источник

NV

Nick Volynkin in DocOps-сообщество
1. У нас очень мало переменных и инклюдов, так что проблемы нет с этим.
2. А чем плохо публиковать доку для ревью? Мы все пулл-реквесты публикуем автоматически на тестовое окружение, это удобно.
источник

FM

Fedor Moroseev in DocOps-сообщество
А что за набор?
источник