Added markdown notes

Author: crocodilestick

changelogs/V4.0/V4.0.0_changelog_V2.md

@@ -306,10 +306,19 @@ The ingest system has been refined with better logging, smarter error handling,
 
 Running CWA on a NAS or network share? Network Share Mode makes it possible with intelligent adaptations for NFS/SMB environments.
 
+> [!IMPORTANT]
+> Always set NETWORK_SHARE_MODE=true when running CWA on NFS/SMB shares to prevent database corruption and permission errors.
+
 ### What It Does
 - **Disables SQLite WAL Mode** - Write-Ahead Logging requires file locking guarantees that many network filesystems can't provide. When `NETWORK_SHARE_MODE=true`, CWA automatically disables WAL on `metadata.db` and `app.db` to prevent "database is locked" errors and corruption risks
+    > [!WARNING]
+    > Enabling WAL mode on network shares can cause “database is locked” errors and potential data loss.
 - **Skips Permission Operations** - Suppresses recursive `chown` operations that fail or cause permission conflicts on network shares (NFS often ignores or misinterprets ownership changes)
 - **Polling-Based File Watching** - Switches from `inotify` to a polling watcher that scans for new files every 5 seconds. Network filesystems often don't propagate filesystem events reliably, and polling ensures ingest always works
+    > [!NOTE]
+    > Polling mode may introduce a few seconds of delay when detecting new files, but ensures reliability on network shares.
+    > [!TIP]
+    > You can force polling mode on any setup with CWA_WATCH_MODE=poll.
 
 ### When You Need It
 - **NFS Mounts** - Synology, TrueNAS, QNAP network shares