ShariX Open Docs

Инструменты пользователя

Инструменты сайта

Вы посетили: • classification
sharixopen:knowledge:classification:start

Содержание

Рубрикатор базы знаний

Навигация: База знаний → Рубрикатор.

Рубрикатор позволяет выбрать материал по нескольким независимым признакам. Одна статья может быть одновременно контрактом API, материалом для интегратора и частью темы заказов. Это не повод помещать её в несколько конкурирующих копий.

Четыре измерения

Поддержка рубрикатора

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

Как устроены связи

  • taxonomy.parents задаёт существующий родительский раздел и ребро contains.
  • depends_on обозначает содержательную зависимость, applies_to — область применения, verified_by — документ критериев проверки. Наличие verified_by не означает, что проверки уже запущены.
  • taxonomy.terms содержит идентификаторы определённых меток и понятий. extensions.glossary определяет их; граф создаёт uses_term и defines_term.
  • extensions.classification хранит те же признаки раздельно: products, audiences, material и иерархические paths тем. Это структура для API, а не набор исполняемых инструкций.

Основная иерархия остаётся «раздел → документ». Дополнительные метки связывают документы поперёк разделов. Вложенность темы записывается путём: например, orders/payments означает «Заказы → Финализация оплаты»; её значение раскрыто в словаре темы.

Почему раньше было reference · unspecified

Каталог этой версии показывает domain и lifecycle, а не полный набор признаков статьи. Ранее domain часто оставался общим reference, а lifecycle — unspecified. Это скрывало различия между правилами, архитектурой и описанием кода.

Теперь:

  • type уточняется по допустимым типам API: policy, architecture, contract, component, procedure, requirement, verification, reference и decision;
  • semantic material в классификации различает, например, указатель, концепцию, подход к разработке и практическое руководство;
  • implemented означает, что описывается существующая реализация исходного кода. Оно не обещает отсутствия ошибок и не подтверждает установленный сервер;
  • not_applicable означает, что стадия реализации функции неприменима: это правило, концепция, словарь, требования или указатель;
  • status остаётся редакционным состоянием текста. Исправление рубрики не делает review автоматически approved.

Reference сохраняется для настоящих указателей, словарей и концептуальных справок: API не имеет отдельного native type для каждого такого подтипа. Их назначение уточняет материал и тема. Учебный курс или упражнение сюда не переносится; они относятся к Moodle.

Как пользоваться

  1. Начать с нужного раздела либо одного из четырёх указателей выше.
  2. Выбрать аудиторию, назначение или тему и открыть связанную статью.
  3. В графе по умолчанию читать иерархию разделов. Для смысловых связей включить нужный тип отношения.
  4. В режиме «Все документы» включить «Использует термин», чтобы видеть общие метки; при большой карте сначала сузить разделы. В текущем viewer более 160 одновременно выбранных узлов не рисуются, текстовый каталог остаётся доступен.
  5. Для точного машинного выбора читать classification и исходные связи через Wiki API. Отдельных полей-фильтров аудитории и продукта в текущем viewer нет; обычные указатели и API-классификация доступны сейчас.

Метки аудитории и продукта не выдают права. Публичная Wiki содержит ShariX Open и разрешённые границы общих компонентов; внутренние детали Platform и закрытых модулей находятся в intrawiki.

Граф знаний ShariX

Фильтруйте по разделам и выбирайте узлы, чтобы перейти к документам.

Текстовая навигация по документам

Каталог знаний

Связанные материалы

sharixopen/knowledge/classification/start.txt · Последнее изменение: — sx_knowledge_api_open
© 2022 ShariX