Add the migration guide for version 7

Author: TolikPylypchuk

CHANGELOG.md

@@ -6,10 +6,11 @@
 
 - `SimpleReactiveGlobalHook` was renamed to `ReactiveGlobalHook`.
 
-- The `Run`, `RunAsync`, and `Stop` methods were moved from `IGlobalHook` and `IReactiveGlobalHook` into
-`IBasicGlobalHook` which both `IGlobalHook` and `IReactiveGlobalHook` now extend.
+- The `Run`, `RunAsync`, and `Stop` methods as well as the `IsRunning` and `IsDisposed` properties were moved from
+`IGlobalHook` and `IReactiveGlobalHook` into `IBasicGlobalHook` which both `IGlobalHook` and `IReactiveGlobalHook` now
+extend.
 
-- Because of the previous change, `RunAsync` for reactive global hooks now returns a `Task` instead of an
+- Because of the above change, `RunAsync` for reactive global hooks now returns a `Task` instead of an
 `IObservable<Unit>`.
 
 - `ReactiveLogSourceAdapter` now contains a single constructor with a default parameter instead of two constructors.

docs/articles/about.md

@@ -61,10 +61,11 @@ You need .NET 9 to build SharpHook.
 
 - `SimpleReactiveGlobalHook` was renamed to `ReactiveGlobalHook`.
 
-- The `Run`, `RunAsync`, and `Stop` methods were moved from `IGlobalHook` and `IReactiveGlobalHook` into
-`IBasicGlobalHook` which both `IGlobalHook` and `IReactiveGlobalHook` now extend.
+- The `Run`, `RunAsync`, and `Stop` methods as well as the `IsRunning` and `IsDisposed` properties were moved from
+`IGlobalHook` and `IReactiveGlobalHook` into `IBasicGlobalHook` which both `IGlobalHook` and `IReactiveGlobalHook` now
+extend.
 
-- Because of the previous change, `RunAsync` for reactive global hooks now returns a `Task` instead of an
+- Because of the above change, `RunAsync` for reactive global hooks now returns a `Task` instead of an
 `IObservable<Unit>`.
 
 - `ReactiveLogSourceAdapter` now contains a single constructor with a default parameter instead of two constructors.

docs/articles/migration.md

@@ -9,6 +9,24 @@ low-level functionality providers, these interfaces need to be changed. Technica
 would require bumping the major version. Instead, changes to these interfaces are usually treated as minor version
 updates since they are not expected to break client code.
 
+## Version 6 to 7
+
+Version 7 contains only a couple breaking changes and most of them are in SharpHook.Reactive.
+
+`SimpleReactiveGlobalHook` was renamed to `ReactiveGlobalHook`.
+
+`RunAsync` in `IReactiveGlobalHook` now returns a `Task` instead of an `IObservable<Unit>`. If you want to have
+`IObservable<Unit>` instead, you should wrap the returned task.
+
+Other breaking changes only require recompilation and don't require changing any code (unless reflection is used).
+
+The `Run`, `RunAsync`, and `Stop` methods as well as the `IsRunning` and `IsDisposed` properties were moved from
+`IGlobalHook` and `IReactiveGlobalHook` into `IBasicGlobalHook` which both `IGlobalHook` and `IReactiveGlobalHook` now
+extend.
+
+`ReactiveLogSourceAdapter` now contains a single constructor with a default second parameter instead of two
+constructors.
+
 ## Version 5 to 6
 
 Version 6 contains multiple breaking changes, so you will most probably need to change your code to upgrade.