Похожие чаты

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

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

4 ответов

3 просмотра

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

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

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

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

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

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

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

А как старый хаскел с новым стыковать ? потому как тут работает https://play.haskell.org/saved/C3xpMzcd, а вот тут https://stepik.org/lesson/7602/step/9?unit=1473 нет ошибка C...
Fedor
131
hey everyone I'm not able to input come characters in my flatpak apps, they get ignored by the application. all other non-flatpak apps are fine with these characters. I search...
elo
20
Guys what is ur real (no jokes) expectation of link price during this cycle?
Hobbyist
28
что насчет пагинга? на осдеве непонятно(
Vi Chapmann 🪙
21
Hey, it seems like a solid project for the gaming industry. What are your initial thoughts?
Josh
26
Вопрос я правильно понимаю что в коде newtype ArrowMap k v = ArrowMap { getArrowMap :: k -> Maybe v } getArrowMap есть функция типа k -> Maybe v, если да, то не понимаю задач...
Fedor
64
Ребят, что лучше для реверса: гидра или ида?
En Vind Av Sorg
26
Works for everyone else, you think think SOL organically went from $8 to $220? Of course it didn’t, they pumped it. First to $20 with the narrative it would go back to $100, ...
Yankee Ruin X
8
if (user?.choseType === 'oneDay') { await ctx.reply( 'Добро пожаловать в команду «Магнита»! Правда, на один день ☺️ ', ); await ctx.s...
Kokni
1
What got more people talking about FTM? The week we were biggest gainer or this week with loads of amazing news but no positive price movement? The week we were biggest gain...
Yankee Ruin X
10
Карта сайта