Size: a a a

2020 February 11

NK

ID:0 in Я шарю
8. Не бэкапит себя. Не делится знаниями с другими командами. Использует бесплатный слак.
источник

NK

ID:0 in Я шарю
9. Нет культуры документирования. Рассинхрон доки и реальности. Никто не знает что и где. Коммит-мессаджи ни о чём.
источник

NK

ID:0 in Я шарю
10. Умышленно скрывал знания.
источник

NK

ID:0 in Я шарю
источник

KS

Kirill Shilov in Я шарю
Хотя я бы всех за это казнил
источник

АК

Александр Кот in Я шарю
Nick Volynkin
Расскажите, как у вас внедрили такую культуру документирования?
На слэк может не быть денег исторически и очень долго, но это не главное, "ой да купите - не купят, пробовали", теперь о главном.

Слэк это бэклог, как jira.

Поясню почему.
Та документация, которая в нем есть, может быстро устареть.

Как вы планируете своевременно обновлять ее? Писать в тред, "а чего это в том абзаце не так сейчас? Сейчас вот так". И в ответ, "да, мы знаем", или "да? Ну тикет заведи" Пять сообщений реально прочесть, но когда ты прочел триллионы и триллионы реализаций, в голове мягко говоря каша. Преисполнился и стартуешь новый тред? Тебе пишут: "было, читай". Начинаешь объяснять что читал и так не работает...

Фиксированием доки могут заниматься люди на обоих концах дискуссии, каждый для своей команды, либо можно выбрать одного, кто запишет и скинет доку в тред.

Необходимое и достаточное условие для документирования: человек должен быть замотивирован и понимать зачем ему это документировать. Кому и как долго эта информация может быть полезна? Будь я своим коллегой, хотел бы найти эту информацию в доступном месте? Будь я тем коллегой, который ответил на вопрос, хотел бы я каждый раз повторять одно и то же, когда ко мне подойдут с этим же вопросом?

Кто вообще ответственен за эту область знаний в компании, можно сообщить ему, и пусть он запишет и будет поддерживать эти знания в актуальном состоянии для всех.

Если информации нет, остальная команда будет постоянно спрашивать, придется либо устно либо письменно объяснять.

Если нет осознанности : зачем документировать, и аргументы не помогают,
то ее можно наработать опытным путём.

Посчитайте время, сколько вы тратите на поиск информации.
Сколько вы тратите на ожидание нужного человека с совещания.
Сколько вы тратите его и своего времени на получение знаний.

Могут ли эти знания быть записаны, чтобы в будущем не ждать источник с совещаний и не становиться самому источником, который ждут?
источник

АК

Александр Кот in Я шарю
Получилось немало,  готов пообщаться офлайн :)
источник

ИЦ

Игорь Цупко in Я шарю
не все единицы информации - это статьи с картинками, требующие частого обновления.
Много инфы - короткая, в стиле стэковерфлоу, и редко меняющаяся.
источник

ИЦ

Игорь Цупко in Я шарю
Готов зарубиться в оффлайне, в сидрерии ближе к концу недели
источник

ИЦ

Игорь Цупко in Я шарю
в Мск
источник

АК

Александр Кот in Я шарю
Игорь Цупко
не все единицы информации - это статьи с картинками, требующие частого обновления.
Много инфы - короткая, в стиле стэковерфлоу, и редко меняющаяся.
Не все, согласен, но я встречал слэк как документация, и это ад.

Я против, чтобы вообще такую фразу произносили. Неокрепшие умы могут это понять как призыв к действию, и забить на остальные виды документации, и начинать внедрять это на уровне компаний.
источник

ИЦ

Игорь Цупко in Я шарю
Александр Кот
Не все, согласен, но я встречал слэк как документация, и это ад.

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

АК

Александр Кот in Я шарю
Игорь Цупко
забота о неокрепших умах толкает людей на жуткие дела 🙂
Признаю, меня цепляет формулировка "slack как документация" и я испытываю вьетнамские флэшбеки, которых никому бы не пожелал. Поэтому готов доказывать примерами, на каком этапе эта идеология заруинит всё.
источник

АК

Александр Кот in Я шарю
Игорь Цупко
Готов зарубиться в оффлайне, в сидрерии ближе к концу недели
И я в МСК, будем на связи 😉
источник

ИЦ

Игорь Цупко in Я шарю
🙂
я бесконечно поддерживаю, но для справедливости - добавьте в доказательство кейсы, когда эта идеология даст удачный пинок под попу.
источник

NK

ID:0 in Я шарю
👏 Победил преступник номер 10, признавшийся в умышленном сокрытии знаний (в особо крупном размере). Он получает билет 🎫 на KnowledgeConf 2020! Приходи на стенд за призом, если ты нас читаешь!
источник

АК

Александр Кот in Я шарю
Игорь Цупко
🙂
я бесконечно поддерживаю, но для справедливости - добавьте в доказательство кейсы, когда эта идеология даст удачный пинок под попу.
Привожу пример-пинок

Я устал доказывать, что не кретин, и перерыл весь слак и там нет того о чем я якобы не знаю, а команда знает, но хочет чтобы я нашел.

Все уверены, что это "было", но забыли когда и в каком виде.

Есть треды, но все не о том.

Уходишь в споры что коммент на коммент на коммент это совсем не то, что сейчас.

Объясняют, как должно работать - доказываешь, что нет, не так работает.

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

Будь единая точка знаний по теме, то опираясь на нее можно было завести тикет и там решать, или в треде решать

Тред на тред на тред это довольно размытая документация.

Минусы:

Плохая индексация

Сложный поиск (все ищут по разному)

Уверенность команды, что всё есть в слэк

Трата времени на доказательства и поиск истины

Низкая понимаемость по прошествии времени.

Отсутствие единой точки истины.
источник

АК

Александр Кот in Я шарю
Отсутствие единой документации и ответственного за нее порождает разные ее толкования
источник

ИЦ

Игорь Цупко in Я шарю
Александр Кот
Отсутствие единой документации и ответственного за нее порождает разные ее толкования
наличие файла в вики / тикетнице, к сожалению, тоже не даёт гарантии обновляемости, наличия ответственного, простоты поиска (при облии данных) и самоуверенности людей в том, в чём они не разбираются, что "ну кто-то там наверное всё решил"
источник

АК

Александр Кот in Я шарю
Игорь Цупко
наличие файла в вики / тикетнице, к сожалению, тоже не даёт гарантии обновляемости, наличия ответственного, простоты поиска (при облии данных) и самоуверенности людей в том, в чём они не разбираются, что "ну кто-то там наверное всё решил"
Согласен, Вики страница дает "иллюзию" что на написанное можно опираться. И в случае чего возможность внести изменения, а не собирать знания по крупицам из слэк.

Более того у страницы есть создатель, есть история изменений. Доступна всем. Можно быстро передать большой объем знаний одной ссылкой.
источник