30 lines
2.8 KiB
Markdown
30 lines
2.8 KiB
Markdown
# Документация WealthLedger
|
|
|
|
Перед изменением прочитай [README](README.md) и [CONTRIBUTING](CONTRIBUTING.md),
|
|
затем только затронутую тему. Docs объясняет систему; требования принадлежат
|
|
основным спецификациям, реализация и coding conventions — соседним репозиториям.
|
|
До edits найди/создай подходящую Gitea Issue, проверь AC и ветку; чтение
|
|
допускается без Issue. Общий маршрут — [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/branch/develop/.ai/conventions/engineering-workflow.md).
|
|
|
|
Проверь существенные факты по локальным тематическим страницам и ADR;
|
|
внешние источники используй как справочные свидетельства, когда они доступны.
|
|
Недостающие факты отмечай явно; инструкции и проверки не требуют других checkout.
|
|
Расхождение обозначь, не выбирая источник
|
|
победителем автоматически. Перенос сохраняет полезное содержание и входящие
|
|
ссылки. Docs описывает текущее устройство системы; история поставок остаётся в Git.
|
|
Отчёты аудитов и исследований в docs не размещаются. Подтверждённые решения
|
|
из исследований оформляются в ADR, системные знания — в тематических страницах.
|
|
|
|
Перед завершением проверь текст, диаграммы и маршруты чтения; выполни
|
|
[доступные проверки](CONTRIBUTING.md#проверки), включая новые файлы.
|
|
Сохрани границы задачи и чужие изменения. Успех Markdown-проверки не заменяет
|
|
смысловую сверку и не доказывает рендер диаграмм.
|
|
|
|
## Ветки и релизы
|
|
|
|
Работа — в issue-linked ветке от `develop`, затем PR в `develop`; в `main` напрямую
|
|
не пушить. Release/hotfix и синхронизация веток — по [README](README.md#релизы).
|
|
Commits и заголовки PR — Conventional Commits со ссылкой на Issue (кроме release);
|
|
для спецификаций допустим `spec:`.
|
|
Перед подготовкой релиза прочитай местный README; версии вручную не повышать.
|