docs: clean up research notes, add production backlog and working docs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Vgmzx8VTTTmCskSpQtsLTr
2026-06-26 18:22:58 +02:00
parent 0d3a3451f3
commit 4df191b9f4
7 changed files with 429 additions and 352 deletions
@@ -0,0 +1,27 @@
+# Git Sync Plugin — Setup Notes
+
+## Folders YAML bug
+
+The plugin UI always saves the folders field as a single comma-string:
+
+```yaml
+folders:
+  - 'pages,config,themes'
+```
+
+But the plugin code iterates the array expecting separate items. This causes `git status pages,config,themes` to be passed as a single path, so git sees nothing to commit and sync silently does nothing.
+
+**Fix:** Edit `user/config/plugins/git-sync.yaml` directly:
+
+```yaml
+folders:
+  - pages
+  - config
+  - themes
+```
+
+Never use the Admin UI to change folders — it will rewrite the broken format.
+
+## Files to gitignore
+
+`user/config/plugins/git-sync.yaml` contains an encrypted token and is server-specific. `user/config/security.yaml` contains Grav nonces/salts, also server-specific. Both are in `.gitignore` and must never be committed.