Области: организация и проект

У каждой записи одна область: вся организация или один проект разработки.

Что во что класть

Организация — то, что верно везде, в любом проекте:

• правила работы («обязательно YAGNI», «комментарии по-русски»);
• решения уровня компании, записанные как правила («в апстрим публикуем только через PR»);
• ссылки на общие ресурсы.

Проект — то, что верно только здесь:

• факты о конкретной кодовой базе и её окружении;
• ловушки сборки и тестов этого проекта;
• решения, принятые в этом проекте.

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

Как это видит модель

Прогон проекта P в организации O получает:

• все активные записи организации O;
• все активные записи проекта P.

Чужие проекты не видны никогда — ни в индексе, ни по требованию.

Как это видят люди

Участник видит записи тех областей, куда достаёт его право чтения: грант на проект даёт записи этого проекта и записи организации; грант на организацию — всё.

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

Кто может писать куда

Общеорганизационные записи — целиком человеческая территория: это правила, по которым работает вся компания, и модель их не устанавливает.