Quartz 4

Вопросы про развитие wiki

active
Not verified

Created · Updated 3 min read

Открытые вопросы про саму wiki — структуру, конвенции, процессы, инструментарий. Не про доменный контент BloodGPT (живёт inline в decisions/ со статусом open/contested и в разделах «Открытые вопросы» на entity/concept-страницах).

Source of truth — inline в страницах knowledge-management, cascade-plugin, CLAUDE.md, уроки. Здесь — navigational view с короткими формулировками для быстрого обзора.

Структура и формат

  • Спецификация vs обсуждение vs реализованное-но-обсуждаемое. В одной wiki-странице могут жить несколько слоёв: что реализовано, что открыто, что сделано но команда хочет пере-обсудить. Сейчас они смешаны. Как разделять структурно — frontmatter-флагом, отдельными разделами, отдельными файлами — не выбрано. Источник: что-в-wiki-—-спецификация-vs-обсуждение-vs-реализованное-но-обсуждаемое.
  • Сегментация по уровням доступа. Не всё в wiki стоит показывать всем. industry/* — sales-relevant, можно делиться шире; team-dynamics.md — внутреннее. Структура access-levels не оформлена. Источник: сегментация-по-уровням-доступа.
  • Связь aggregator-страниц с inline source-of-truth. вопросы-по-доменам и уроки — aggregator-страницы. Maintenance contract зафиксирован, но автоматического lint-pass нет. Работают пока вручную.

Sharing с коллегами

  • Какой shared layer для комментариев. Локальные markdown → коллегам нужен способ читать и комментировать. Кандидаты: Notion как зеркало, CriticMarkup напрямую, GitHub PR-комментарии, сервис-обёртка над git-репо (GitDoc / Gitiles / WikiJS). Не выбран. Источник: sharing-с-коллегами-с-возможностью-комментариев.
  • Расширение CriticMarkup на коллег. Сейчас Макс уже работает с CriticMarkup в Obsidian — практика начала распространяться. Что нужно для дальнейшего расширения (документация для коллег, onboarding) — не зафиксировано.

Tooling и автоматизация

  • Реанимировать ли Cascade Plugin. Для конкретных частей продукта (например, FHIR Gravity middleware) трёх-уровневая структура спек может быть оправдана. Решение не принято. Источник: открытые-вопросы.
  • Cascade без Google Docs. Возможна ли версия Cascade без Google Docs — сразу markdown-в-git с CriticMarkup для комментариев. Идея, не проработана. Источник: открытые-вопросы.
  • Lint policy. В CLAUDE.md упомянут lint (broken wikilinks, stale frontmatter, отсутствие «Связано» / «Источники», placeholder без content >30 дней) — не реализован как автоматический pass. Источник: CLAUDE.md раздел «Что ещё стоит зафиксировать».

Структура папок

  • Когда переименовывать страницу vs создавать новую. Порог не зафиксирован — ориентировочно «если scope значимо изменился». На практике решается ad-hoc. Источник: CLAUDE.md раздел «Что ещё стоит зафиксировать».
  • specs/decisions/ интеграция в wiki. RFC-формат можно интегрировать в wiki напрямую — упростит жизнь. Не сделано. Источник: от-чего-отказываемся-явно.
  • Что в meta/ vs team/. Зафиксировано (Apr 27 2026): meta/ — wiki conventions (CLAUDE.md, уроки, эта страница, вопросы-по-доменам); team/ — процессы команды (knowledge-management, cascade-plugin, team-dynamics). Может потребовать дальнейшего уточнения когда появится больше страниц.

Что не обсуждали (но возможно стоит)

  • Производные форматы. Pitch deck, customer-facing one-pagers, sales collaterals — производные артефакты wiki. Процесс производства не зафиксирован. Раньше был как open вопрос, потом признан как неоткрытый — может выскочить позже.

Связано

  • knowledge-management — общий обзор подхода (4 итерации)
  • cascade-plugin — Cascade методология
  • CLAUDE.md — wiki conventions
  • уроки — methodology lessons
  • decisions/*.md (status open / contested / proposed) — открытые архитектурные вопросы по доменам

Graph View

Backlinks