Комментарии 9
для меня лучшая база знаний - исходники и багтрекер.
во всем остальном рано или поздно выходит "Рабинович по телефону напел"
Интересный материал, но можете привести пример (пусть даже отвлечёный) материала, который хранится в такой базе знаний?
Что такое "эл-ты" в таблице?
Есть ли в таких базах знаний контроль версий, возможность реценцирования и закрытия окончательной и утверждёной версии от дальнейшего редактирования? Т.е. закрепления документа в статусе "документ под контролем"?
С последнего начну: ревью и жесткому контролю подвергаются верхнеуровневые разделы/страницы - для этого создана "песочница", полностью дублирующая структуру всей бз, перенос из которой на бой осуществляет два, три человека.
При этом есть различные динамические инструменты, которыми ежедневно пользуются многие сотрудники и ревью которых просто бессмысленно. Как пример, подготовка рассылок.
Сорре за блюр))
Ну и в целом, стараемся сделать базу знаний максимально не просто инструментом хранения информации, а именно инструментом создания этой информации (звучит, как масло масляное, но надеюсь, понятно о чем).
Как показывает многолетняя практика, можно составить всеобъемлющую базу знаний, но невозможно её поддерживать в актуальном состоянии длительное время. Более того, попытки побороть это могут привести к обратному эффекту - дезинформации: либо уставший инженер не так (не там) изложит свои мысли, либо технический писатель не так поймет и не правильно зафиксирует то, что ему объяснил уставший инженер. Статический текст не работает, одним словом. Со временем приходишь к тому, что единственно надежный способ закреплять знания и опыт должен быть динамичным: в виде строгих процессов BPM (в любой среде мониторинга процессов) или с помощью банальной автоматизации процессов (CI\CD) - это работает.
Текстовую базу знаний еще можно оправдать, когда она представляется базой указателей, которая лишь прочертит общий путь, но не даст всеобъемлющих ответов на интересующие вопросы (простой текст просто не способен это сделать). А указатели уже могут указывать и на живых людей, и на чаты.
Если речь про документацию кода, API и тд, то полностью согласен - кажется оч плохой идеей использование статического инструмента, который еще и не связан напрямую с документируемыми объектами. Но у нас тех. команда использует бз для наполнения своих вики, описания процессов, ADL, тех. решений и тд и тп.
Ну и плюсом к этому база знаний используется во всей команде, для некоторых из которой это становится вообще одним из основных инструментом.
Как-то мало по теме базы знаний. Мало информации по организации самой базы знаний... Много воды и очень мало конкретики...
Документируй или столкнись с хаосом: как мы создали базу знаний в стартапе