diff --git a/docs/migrate-1-0-28.md b/docs/migrate-1-0-28.md
index b6ae4fda4..e7771ad91 100644
--- a/docs/migrate-1-0-28.md
+++ b/docs/migrate-1-0-28.md
@@ -43,6 +43,10 @@ Parse().initialize(
 );
 ```
 
+### optional: adjust your tests
+You tests might fail if the package tries to automatically discover facts like you applications name, version, package name or the default file directory.
+You can avoid this automatic discovery by providing values for `appName`, `appVersion`, `appPackageName` as well as `fileDirectory` at you `Parse().initialize()` call.
+
 ### changed network library
 In order to provide a `ProgressCallback` for heavy file operations,
 the network library was switched from [http](https://pub.dev/packages/http) to [dio](https://pub.dev/packages/dio).