From 1e351cbb9bf921caaf2b69281597c605e0c74967 Mon Sep 17 00:00:00 2001 From: MagentaDolphin Date: Thu, 3 Sep 2026 17:10:29 +0700 Subject: [PATCH] docs: record the version control arrangement The plugin is its own repository with no remote yet. Writing down why there is no .gitmodules entry: an entry without a working URL breaks git submodule update --init for everyone running SetupProject.bat. Co-Authored-By: Claude Code --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index fac5829..e6098a5 100644 --- a/README.md +++ b/README.md @@ -366,6 +366,25 @@ Reference Viewer сам по себе не источник истины: он --- +## Контроль версий + +Плагин — **самостоятельный git-репозиторий** внутри `Plugins/`, как остальные 26 плагинов проекта. Удалённого сервера пока нет: репозиторий и выделенный remote ещё не согласованы. + +Из этого следуют две вещи: + +- в `.gitmodules` записи **нет** и быть не должно, пока нет URL. Запись без рабочего адреса уронит `git submodule update --init` в `SetupProject.bat` у всех, кто дёрнет проект; +- родительский репозиторий видит папку как `?? Plugins/AssetUsageAudit/`. Так и задумано: коммитить её содержимое в родителя нельзя, иначе при появлении сабмодуля будут две копии одних файлов. + +**История живёт только на машине разработчика.** Как только появится remote: + +```bash +git -C Plugins/AssetUsageAudit remote add origin +git -C Plugins/AssetUsageAudit push -u origin master +git submodule add Plugins/AssetUsageAudit +``` + +Артефакты сборки (`Binaries/`, `Intermediate/` — 231 МБ) исключены локальным `.gitignore`. В Perforce плагин не попадает: `Plugins/**` исключён в `.p4ignore`. + ## Связанное - `.docs/architecture/asset-usage-audit.md` — заметка в базе знаний