📚 ГОСТ или нет? А что, если это справочник?
Вчера мы говорили про подходы к документации в компаниях. И под постом всплыл закономерный комментарий: «Зачем придумывать что-то новое, если есть ГОСТ?»
С одной стороны, да, ГОСТ — рабочая штука. Но рабочая ли она везде?
Давайте будем честны ГОСТ, а чаще (в срезе документации) это именно ЕСКД, ЕСПД — это подходы, которые разработали около 50 лет назад, когда ритм разработки был совершенно другим. Сегодня мы живем в мире, где: ✔️ Продукты обновляются быстрее. ✔️ Требуется постоянная актуализация данных. ✔️ Документация не может быть зацементированной.
📌 И тут ГОСТ начинает нас ограничивать. Он хорош, когда нужно сдать проект или запаковать документацию под поставку железа. Но в динамично развивающемся ПО — вызывает вопросы. А главное, если предлагать разработчикам писать документацию по ГОСТу, они взвоют и начнут прятаться.
Но окей, с этим более-менее разобрались. А что делать экспертам, которые хотят передать знания?
В компаниях хотя бы понятны правила игры: продуктовая документация, база знаний, регламенты. А если ты сам по себе и хочешь написать что-то полезное для других?
Например, мы с Мишей сейчас работаем над справочником по финтеху. И столкнулись с двумя большими проблемами: 1️⃣ Как передавать знания, если читатель не может задать уточняющие вопросы? Когда ты консультируешь, всегда есть диалог. Но в справочнике нет места вопросам. Значит, надо формулировать материал так, чтобы он был однозначно понятен и применим. 2️⃣ Как структурировать накопленные знания, если они изначально записывались "для себя"? Если у вас когда-нибудь была папка с заметками, в которой вроде бы есть ВСЁ, но ничего нельзя найти — вы понимаете боль. 🤯
В корпоративных базах знаний эту проблему решают knowledge-менеджеры. Но когда ты делаешь личный справочник, ты остаешься один на один с хаосом своих мыслей.
И тут спасибо компании ОНТИКО за наше счастливое детство 😂: я осознала, что сама с этим не справлюсь и пошла к ПК KnowledgeConf — ребятам, которые как раз занимаются систематизацией знаний. 🔔 Уже в эту пятницу в 18:00 (МСК) мы стартуем, возможно, целую серию встреч, где будем разбираться: ✔️ Как экспертам правильно выстраивать личные базы знаний? ✔️ Как систематизировать контент, чтобы его можно было использовать вне контекста создателя? ✔️ С чего вообще начинать, если хочется написать свой справочник?
Если вам это важно и интересно — welcome, присоединяйтесь! 📝✨
❗️PS Ссылка на эфир будет за час до мероприятия. Встреча будет в GoogleMeet.