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 <noreply@anthropic.com>
This commit is contained in:
2026-09-03 17:10:29 +07:00
parent 72bf94d142
commit 2c82680a42
+19
View File
@@ -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 <url>
git -C Plugins/AssetUsageAudit push -u origin master
git submodule add <url> Plugins/AssetUsageAudit
```
Артефакты сборки (`Binaries/`, `Intermediate/` — 231 МБ) исключены локальным `.gitignore`. В Perforce плагин не попадает: `Plugins/**` исключён в `.p4ignore`.
## Связанное ## Связанное
- `.docs/architecture/asset-usage-audit.md` — заметка в базе знаний - `.docs/architecture/asset-usage-audit.md` — заметка в базе знаний