Таксономия базы знаний
Т. — учение о классификации сложных иерархических систем. Здесь: система классификации статей в базе знаний (в конфлюенсе, вики, БД).
Принципы
Найти статью базе знаний будет легче, если она снабжена метками (тэгами) в соответствии с принятой на проекте таксономией.
Статья может быть снабжена метками из следующих разделов:
Аудитория, Тип документа, Тема, Система, Функция
Как работают метки
Пример для конфлюенса
Чтобы добавить метку, нажмите справа-внизу страницы на иконку бейджика, появится всплывающее окно. Метка создаётся в конфе, когда её первый раз присваивают странице. Метка удаляется из конфы, когда не остаётся больше страниц с такой меткой.
Правила именования меток
Формат названия:
— строчные (малые) буквы
— слова-разделены-дефисом (kebab-case)
— первое слово метки определяет раздел таксономии: аудитория-; тип-; продукт-; тема-; система-; функция-.
Для метки используется только русский язык. Названия систем, функций и модных фичей переводим в удобоваримый аналог на русском языке (например «система-нав»). Таким образом мы всегда будем знать, как набирать название метки в конфе.
Правила для тематических меток
Метки из группы «тема-*» создаются путем перечисления сущностей из предметной области от общего-к-частному во множественном числе. Например:
тема-товары-остатки
тема-товары-цены
тема-товары-отображение
тема-заказы-статусы
тема-рефералка-управление
К чему я это всё? Нашёл сегодня свою собственную статью в базе знаний проекта и понял, что неплохо её проработал для использования на любых проектах, где документации больше чем пара десятков страниц. Метки удобны тем, что их можно гибко фильтровать и создавать промежуточные страницы для группировки сходных документов, которые лежат исходно в разных ветках базы знаний.
Например: «Фиды», «Алгоритмы ETL», «Обработка остатков» и так далее.
P.S. Для классификации страниц идеально использовать языковые модели; NLP — их сильная сторона.
Т. — учение о классификации сложных иерархических систем. Здесь: система классификации статей в базе знаний (в конфлюенсе, вики, БД).
Принципы
Найти статью базе знаний будет легче, если она снабжена метками (тэгами) в соответствии с принятой на проекте таксономией.
Статья может быть снабжена метками из следующих разделов:
Аудитория, Тип документа, Тема, Система, Функция
Как работают метки
Пример для конфлюенса
Чтобы добавить метку, нажмите справа-внизу страницы на иконку бейджика, появится всплывающее окно. Метка создаётся в конфе, когда её первый раз присваивают странице. Метка удаляется из конфы, когда не остаётся больше страниц с такой меткой.
Правила именования меток
Формат названия:
— строчные (малые) буквы
— слова-разделены-дефисом (kebab-case)
— первое слово метки определяет раздел таксономии: аудитория-; тип-; продукт-; тема-; система-; функция-.
Для метки используется только русский язык. Названия систем, функций и модных фичей переводим в удобоваримый аналог на русском языке (например «система-нав»). Таким образом мы всегда будем знать, как набирать название метки в конфе.
Правила для тематических меток
Метки из группы «тема-*» создаются путем перечисления сущностей из предметной области от общего-к-частному во множественном числе. Например:
тема-товары-остатки
тема-товары-цены
тема-товары-отображение
тема-заказы-статусы
тема-рефералка-управление
К чему я это всё? Нашёл сегодня свою собственную статью в базе знаний проекта и понял, что неплохо её проработал для использования на любых проектах, где документации больше чем пара десятков страниц. Метки удобны тем, что их можно гибко фильтровать и создавать промежуточные страницы для группировки сходных документов, которые лежат исходно в разных ветках базы знаний.
Например: «Фиды», «Алгоритмы ETL», «Обработка остатков» и так далее.
P.S. Для классификации страниц идеально использовать языковые модели; NLP — их сильная сторона.