Похожие чаты

Коллеги, подскажите, пожалуйста, как удобнее организовать структуру документации для девопсов?

У них полнейший бардак и авгиевы конюшни.
Мне кажется, сперва нужно подойти к формированию структуры при помощи примитивной схемы взаимосвязей среди уже имеющихся доков.

4 ответов

13 просмотров

Я бы начал с бизнес-процессов.. а дальше на них уже вешать документы (это если нужно строго)

Ярославна- Автор вопроса
Dexiter
Я бы начал с бизнес-процессов.. а дальше на них уж...

Не строго, чисто для внутреннего пользования, структурировать уже имеющееся и мб продумать наперёд. Я просто занималась только ТЗ, руководствами и тп. Может у кого из присутствующих есть интересный рабочий кейс.

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

Согласна с коллегами, что: 1. Надо сначала изучить user story самих девопсов, где сначала они делают это, потом это, затем это. Это будет первое приближение структуры; 2. Затем не стоит забывать, что они пишут доку сами. Им надо будет легко находить нужные места в структуре, куда положить свои статьи. Надо будет новую структуру на них потестить.

Похожие вопросы

Обсуждают сегодня

а через ESC-код ?
Alexey Kulakov
29
30500 за редактор? )
Владимир
47
Чёт не понял, я ж правильной функцией воспользовался чтобы вывести отладочную информацию? но что-то она не ловится
notme
18
У меня есть функция где происходит это: write_bit(buffer, 1); write_bit(buffer, 0); write_bit(buffer, 1); write_bit(buffer, 1); write_bit(buffer, 1); w...
~
13
any reference of this implementation?
BitBuddha
29
Ⓐrtto, [4/23/24 7:02 PM] Please explain more fully how it is not working exactly, and what are the steps you are taking, and what error messages come or what happens. Ⓐrtto, ...
Ezza Kezza
2
sounds like people have lost their kaspa on tradeogre... does this mean tradeogre not trustworthy?
Ezza Kezza
15
Страшнейшая правда про списки ЦБ. С первых дней жизни P2P сферы, молодые человеки, начитавшись законодательной базы и "внутренних" документов, решили, что им противостоит сер...
Foxcool
3
Недавно Google Project Zero нашёл багу в SQLite с помощью LLM, о чём достаточно было шумно в определённых интернетах, которые сопровождались рассказами, что скоро всех "ибешни...
Alex Sherbakov
5
So much speculation in the last week. So much volatility in price. This is because Hedera has a GC that isn't using the network it's governing. Why aren't people asking why a...
Summit Seeker R
9
Карта сайта