From 8540372d32f6015fe1bf8e9354ff1e22b6cc5d1c Mon Sep 17 00:00:00 2001
From: Vsevolod Stakhov <vsevolod@highsecure.ru>
Date: Thu, 17 Sep 2015 18:59:38 +0100
Subject: [PATCH] Add migration notes.

---
 doc/markdown/migration.md | 46 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 45 insertions(+), 1 deletion(-)

diff --git a/doc/markdown/migration.md b/doc/markdown/migration.md
index c7da01cd0..7a6003698 100644
--- a/doc/markdown/migration.md
+++ b/doc/markdown/migration.md
@@ -4,7 +4,51 @@ This document describes incompatible changes introduced in the recent rspamd
 versions. Here you can find information about how to overcome this incompatibilities
 and update your rules and configuration according to these changes.
 
-## Migrating from rspamd 0.6 to rspamd 0.7 {#0607}
+## Migrating from rspamd 0.9 to rspamd 1.0
+
+In rspamd 1.0, the default settings for statistics tokenization has been changed to `modern`, meaning
+that now tokens are generated from the normalized words and there are various improvements incompatible with the
+statistics model used in pre 1.0 versions. Therefore, to use all these advantages you should either **relearn**
+your statistics or continue using your old statistics **without** new features by adding `compat` parameter:
+
+~~~nginx
+classifier {
+...
+    tokenizer {
+        compat = true;
+    }
+...
+}
+~~~
+
+The recommended way to create statistics now is `sqlite3` backend (which is incompatible with old mmap backend however):
+
+~~~nginx
+classifier {
+    type = "bayes";
+    tokenizer {
+        name = "osb";
+    }
+    cache {
+        path = "${DBDIR}/learn_cache.sqlite";
+    }
+    min_tokens = 11;
+    backend = "sqlite3";
+    languages_enabled = true;
+    statfile {
+        symbol = "BAYES_HAM";
+        path = "${DBDIR}/bayes.ham.sqlite";
+        spam = false;
+    }
+    statfile {
+        symbol = "BAYES_SPAM";
+        path = "${DBDIR}/bayes.spam.sqlite";
+        spam = true;
+    }
+}
+~~~
+
+## Migrating from rspamd 0.6 to rspamd 0.7
 
 ### Webui changes
 
-- 
2.39.5