зануда

🙄

хотела предложить раскладку бирмана, но потом прочитала про код

👋

Привет!

Добрый день!

Как продать начальнику новую структуру документации?

Вопрос от читательницы канала:

У нас вики в очень плохом состоянии. Хочу предложить начальнику свой вариант, как организовать документацию.
Общая ситуация такая: вся документация перепутана. Она сложная, потому что система непростая. Новая структура документации должна помочь в работе сотрудникам. Они будут точно знать, где и какой документ искать, где и по каким шаблонам содавать документы. Начальство предлагает упростить документацию, но общего видения нет. И я понимаю, что предложения начальства тоже не принесут желаемого результата.
Как „продать” начальнику свой вариант, какие аргументы привести? Как себя вести в таких случаях?

Приходите обсудить этот вопрос в t.me/docsascode. Свой ответ я туда же напишу.

Коллеги, у меня созвон на часок, а потом я напишу, что сам думаю )

С кем созваниваешься?

Как-то это слишком личный вопрос для чата на 160 человек.

Да я угараю, дядь

Это я к тому, что обещал написать свой ответ.

как пример очень классно офромленной этикетки

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

Ну или просто принести начальству шоколадку.

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

вот если есть метрики, дальше гораздо проще говорить об измеряемых изменениях

Откуд стока новых людей, рекламка чтоль где-то пролетела?

Тема для обсуждения новая заявлена в канале DocOps