Коллективные базы знаний

Что за хаб?

еще немного текста для увеличения полезности сообщения

1 симпатия

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

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

zttl.wiki

1 симпатия

Ааа, notion.

Ну да, на форуме значительно удобнее, конечно.

1 симпатия

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

Но по ощущениями должно быть бодро.

1 симпатия

Коллективная БД знаний – это плохо. Хотя бы потому, что у каждого своя голова, а в ней свой жизненный опыт.

Вот вы открываете заметку, а там:

Концепция аналогична enum.Enum.

Только эти черти думают, что они самые умные и нумерацию начали с 0, как в Си, а не как нормальные люди.

И как вам такое? Мне было бы понятно (в т.ч. из-за стиля изложения), а вам? Или кому-то ещё без моего багажа?

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

Очевидно, что устанавливают некоторые правила/ограничения, в том числе и на коллективную документацию/базу знаний.

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

3 симпатии

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

Полностью не нужно, но частично – обязательно придется синхронизировать. Именно этот процесс частичной синхронизации голов команды и поддерживается Базой знаний, которая в свою очередь может быть реализована в “Confluence или любой иной системы документации”.

А собственно то, как это организовать (метод) и есть онтопик.

1 симпатия

По теме натыкался на такую вот статейку на хабре

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

3 симпатии

Большое спасибо, статья действительно очень интересная!

Самое главное, что вынес из нее - необходимость создания процессов вокруг документации. Хотя вот что конкретно здесь имеется ввиду под документацией вроде бы и понятно, но не понятно, как именнно это реализовывать. Последнее время много слышу про конфлюенс, но попробовать с ним работать не получилось - заблокировали подключение новых пользователей. Если кто-то пользовался конфлюенсом, поделитесь - чем работа там отличается от привычных сообществу Обсидиана и прочих заметочников?

1 симпатия

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

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

Беда в том, что все те вопросы, которые я задавал (“Почему эта штука ведет себя так?” или “Как мне добраться вот до этой логики?”), требовали от меня несколько дней исследований, но ответ фактически сводится к двум-трем строкам. Я пока не вижу, как это можно было бы представить в виде какого-то связного документа.

По мне тут первые вопросы:

  • кому и при каких примерно обстоятельствах эта информация будет нужна? Где этим “кому” может прийти в голову искать информацию?
  • предполагается ли, что кто-то ещё будет эту базу редактировать?
2 симпатии

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

Обстоятельства, похоже, каждый раз разные. Описываются словами “у нас тут поведение не такое, как мы ожидали”.

База точно будет не в виде “только для чтения”, но опять же опыт подсказывает, что люди обычно не горят желанием что-то дописывать.

2 симпатии

Я вот сейчас пробую именно внутри небольшой команды следующий способ:
Приватный репозиторий на гитхабе, там база Obsidian, где какая-то пока не до конца определенная структура (Одна “точка входа” со ссылками на другие блоки - области деятельности, которые уже как MOC в конкретной области).
Плюсы:

  • Если все понимают как это работает и как этим пользоваться то можно делать суперинтересные вещи совместно

Минусы:

  • Если кто-то не понимает или не хочет понимать логику работы то работа сложа, особенно учитывая что надо установить и запустить Obsidian, как минимум. В итоге трудозатраты оказываются больше чем “пойти и спросить чтобы он поковырялся в заметках”)

В остальном с теми людьми кто, как и я, любит и понимает возможности Obsidian, работать приятно, но нет понимания как это масштабируется.
Ну и инструкцию пытаюсь писать для менее заинтересованных)

Было бы интересно почитать инструкцию или кусочки из нее :slight_smile:

Лично я не готов для работы с базой знаний ставить какой-то дополнительный софт, предпочел бы обойтись просто браузером.

Когда сделаю и буду готов поделиться - пришлю сюда обязательно)

1 симпатия

Я для создания открытой пользовался Obsidian Publish, но сейчас т.к. его не оплатить рассматривал и плагины для публикации. Вот в этой теме я ошибочно их порекомендовал, забыв, что там не решается вопрос именно приватности, которая критичная для командной базы знаний.
Например, вот в этой и этой темах рассматривается discourse, который можно использовать как базу знаний в вебе. Еще я слышал про Confluence, но самому попробовать не получается сейчас.

Так что если найдете какой-то способ создания приватной базы в вебе - обязательно поделитесь, будет интересно узнать :slight_smile:

Вопрос в другом, зачем нужна приватность? Понимаю, есть всякие вещи, которыми часто чуствительны к приватности, но мне, например не стыдно показывать то что наворотил в заметках.

С ошибками, и процессом работы еще над ними. Не совсем выверенными и так далее. К тому же в базе знаний не держу дневника событий, в котором иногда бывает прям ужас ужасный, с матюками ))

С меня например чучело набьют, если я опубликую базу знаний, связанную с работой.

И правильно сделают.

3 симпатии