Updated Bichon Data Migration: v0.3.7 → v1.0 (markdown)

Bichon-Data-Migration:-v0.3.7-→-v1.0.md

@@ -38,6 +38,32 @@ If `--bichon-index-dir` or `--bichon-data-dir` were customized, `bichon-indices/
 
 ---
 
+## Before Starting the Migration
+
+Before running the migration tool:
+
+1. **Stop the existing v0.3.7 bichon server completely**
+
+   * Ensure no bichon process is still running.
+   * Migration must not be performed while the old server is actively writing data.
+
+2. **Use the latest available v1.x.x release**
+
+   * It is strongly recommended to use the latest `bichon` and `bichon-admin` versions,
+     as newer releases may include migration fixes, memory optimizations, or data
+     consistency improvements.
+
+3. Run the migration using `bichon-admin`.
+
+4. After the migration finishes successfully:
+
+   * Start the new v1.x.x bichon server.
+   * It is recommended to keep the legacy data for a few days after migration. Only remove the old data once the new server has been running stably and the migration has been fully validated.
+
+> **Warning:** Do not start the v1.x.x server before migration has completed successfully.
+
+
+
 ## Running the Migration
 
 Run `bichon-admin` and select: