📚 ГОСТ или нет? А что, если это справочник?

Вчера мы говорили про подходы к документации в компаниях. И под постом всплыл закономерный комментарий: «Зачем придумывать что-то новое, если есть ГОСТ?»

С одной стороны, да, ГОСТ — рабочая штука. Но рабочая ли она везде?

Давайте будем честны ГОСТ, а чаще (в срезе документации) это именно ЕСКД, ЕСПД — это подходы, которые разработали около 50 лет назад, когда ритм разработки был совершенно другим. Сегодня мы живем в мире, где: ✔️ Продукты обновляются быстрее. ✔️ Требуется постоянная актуализация данных. ✔️ Документация не может быть зацементированной.

📌 И тут ГОСТ начинает нас ограничивать. Он хорош, когда нужно сдать проект или запаковать документацию под поставку железа. Но в динамично развивающемся ПО — вызывает вопросы. А главное, если предлагать разработчикам писать документацию по ГОСТу, они взвоют и начнут прятаться.

Но окей, с этим более-менее разобрались. А что делать экспертам, которые хотят передать знания?

В компаниях хотя бы понятны правила игры: продуктовая документация, база знаний, регламенты. А если ты сам по себе и хочешь написать что-то полезное для других?

Например, мы с Мишей сейчас работаем над справочником по финтеху. И столкнулись с двумя большими проблемами: 1️⃣ Как передавать знания, если читатель не может задать уточняющие вопросы? Когда ты консультируешь, всегда есть диалог. Но в справочнике нет места вопросам. Значит, надо формулировать материал так, чтобы он был однозначно понятен и применим. 2️⃣ Как структурировать накопленные знания, если они изначально записывались "для себя"? Если у вас когда-нибудь была папка с заметками, в которой вроде бы есть ВСЁ, но ничего нельзя найти — вы понимаете боль. 🤯

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

И тут спасибо компании ОНТИКО за наше счастливое детство 😂: я осознала, что сама с этим не справлюсь и пошла к ПК KnowledgeConf — ребятам, которые как раз занимаются систематизацией знаний. 🔔 Уже в эту пятницу в 18:00 (МСК) мы стартуем, возможно, целую серию встреч, где будем разбираться: ✔️ Как экспертам правильно выстраивать личные базы знаний? ✔️ Как систематизировать контент, чтобы его можно было использовать вне контекста создателя? ✔️ С чего вообще начинать, если хочется написать свой справочник?

Если вам это важно и интересно — welcome, присоединяйтесь! 📝✨

❗️PS Ссылка на эфир будет за час до мероприятия. Встреча будет в GoogleMeet.

📚 ГОСТ или нет? А что, если это справочник?
Вчера мы говорили про подходы к документации в компаниях | Сетка — социальная сеть от hh.ru 📚 ГОСТ или нет? А что, если это справочник?
Вчера мы говорили про подходы к документации в компаниях | Сетка — социальная сеть от hh.ru