Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Ecosystem Docs (dev-first)

Структура

  • Папка сервиса (escrow/, wallet/, bridge/): свой README.md, а внутри — flows/, decisions/ (ADRы), problems/, diagrams/ (Mermaid/PlantUML). Всё локально к сервису.
  • flows/ — общие/сквозные флоу (когда затрагиваются несколько сервисов).
  • main/ — общие черновики, резюме ключевых решений.
  • problems/ — расследования инцидентов, руткозы, «что пошло не так».

Основные правила

  1. Определи цель заметки в первой строке.
  2. Если фиксируется решение → мини‑ADR: Context → Decision → Consequences.
  3. Диаграммы — только текстовые (Mermaid/PlantUML) рядом с MD.
  4. Ссылки вместо копипасты (код, регуляторные документы, RFC/ADR).
  5. В конце — 3–5 буллетов «что дальше» или чек‑лист.

Быстрый шаблон записи (копируй в новый файл)

Title: <кратко>
Status: draft
Owner: <ник>
Context: <1–3 предложения>
Decision / Notes: <факты, решения>
Links: <код/ADR/источники>
Next: <до 5 пунктов>