diff --git a/doc/README.sonar-migration.md b/doc/README.sonar-migration.md
index a4ab89198..f9ad8ae0e 100644
--- a/doc/README.sonar-migration.md
+++ b/doc/README.sonar-migration.md
@@ -12,6 +12,8 @@ Command line tool to collect SonarQube data to prepare eventual migration to Son
 [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=okorach_sonar-tools&metric=bugs)](https://sonarcloud.io/dashboard?id=okorach_sonar-tools)
 [![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=okorach_sonar-tools&metric=ncloc)](https://sonarcloud.io/dashboard?id=okorach_sonar-tools)
 
+[What's new](https://github.com/okorach/sonar-tools/blob/master/doc/what-is-new.sonar-migration.md)
+
 **DISCLAIMER**: This software is community software.
 
 
diff --git a/doc/what-is-new.sonar-migration.md b/doc/what-is-new.sonar-migration.md
new file mode 100644
index 000000000..8c6a244a8
--- /dev/null
+++ b/doc/what-is-new.sonar-migration.md
@@ -0,0 +1,41 @@
+# Next version yet unreleased
+
+# Version 0.2
+
+- Added export of:
+  - Users email and SCM accounts when available
+  - Users last SonarQube and SonarLint login date
+  - Per project:
+    - Issues coming from instantiated rules (e.g. custom secrets)
+    - Hotspots which have been reviewed as SAFE or FIXED
+- sonar-migration has its own user agent to be recongnized in SonarQune access.log
+- Added check whether the running version is the last released
+- Fixed crash when accessing a portfolio with not enough permissions
+- `sonar-migration` now has its own doc pages (readme and what's new)
+
+# Version 0.1
+
+- First alpha release
+- On top of the regular `sonar-config` export the follwoing is added
+  - Global:
+    - List of 3rd party plugins installed
+  - Per project
+    - Last analysis date
+    - Ncloc w/ breakdown by language
+    - Detected CI
+    - Main branch revision
+    - Last background task scanner context and warnings
+    - Background Task history
+    - Issues:
+      - # of issue False positive
+      - # of issues Won’t fix
+      - # of issues Accepted
+      - # of issues generated by 3rd party rules (with breakdown per rule)
+    - For each branch:
+    - Last analysis date
+    - Ncloc w/ breakdown by language
+    - Issues
+      - # of issue False positive
+      - # of issues Won’t fix
+      - # of issues Accepted
+      - # of issues generated by 3rd party rules (with breakdown per rule)
diff --git a/setup_migration.py b/setup_migration.py
index 25b12b7c1..8c662e3f2 100644
--- a/setup_migration.py
+++ b/setup_migration.py
@@ -40,7 +40,7 @@
     url="https://github.com/okorach/sonar-tools",
     project_urls={
         "Bug Tracker": "https://github.com/okorach/sonar-tools/issues",
-        "Documentation": "https://github.com/okorach/sonar-tools/README.md",
+        "Documentation": "https://github.com/okorach/sonar-tools/doc/README.sonar-migration.md",
         "Source Code": "https://github.com/okorach/sonar-tools",
     },
     packages=setuptools.find_packages(),
diff --git a/sonar_migration b/sonar_migration
index 61a5390e8..31ab6c220 100755
--- a/sonar_migration
+++ b/sonar_migration
@@ -28,5 +28,5 @@ sonar-migration version {version.PACKAGE_VERSION}
 
 run: sonar-migration -u <SonarQubeURL> -t <SonarAdminUserToken>
 
-See tools built-in -h help and https://github.com/okorach/sonar-tools for more documentation
+See tools built-in -h help and https://github.com/okorach/sonar-tools/doc/README.sonar-migration.md for more documentation
 ''')