docs: describe requestAccessibility more precisely

Author: sentialx

docs/breaking-changes.md

@@ -0,0 +1,29 @@
+# Breaking changes
+
+List of breaking changes between major versions.
+
+## Planned Breaking API Changes (2.0)
+
+### `windowManager.getScaleFactor(monitor: number)`
+
+```typescript
+// Deprecated
+windowManager.getScaleFactor(windowManager.getActiveWindow().getMonitor());
+// Replace with
+windowManager.getActiveWindow().getMonitor().getScaleFactor();
+```
+
+### `window.getMonitor(): number`
+
+Now the `window.getMonitor` method returns [`Monitor`](monitor.md) object.
+
+### `windowManager.requestAccessibility()` `macOS`
+
+The `windowManager.requestAccessibility` method won't be required before each operation on windows anymore. Only on:
+
+- `window.setBounds`
+- `window.maximize`
+- `window.minimize`
+- `window.restore`
+- `window.bringToTop`
+- `window.getTitle`

docs/window-manager.md

@@ -16,7 +16,18 @@ console.log(window.getTitle());
 ### Instance methods
 
 #### windowManager.requestAccessibility() `macOS`
-  Required before any action on macOS.
+  
+If the accessibility permission is not granted on `macOS`, it opens an accessibility permission request dialog.
+
+The method is required to call before calling the following methods:
+
+- `window.setBounds`
+- `window.maximize`
+- `window.minimize`
+- `window.restore`
+- `window.bringToTop`
+- `window.getTitle`
+
 - Returns `boolean`
 
 #### windowManager.getActiveWindow() `Windows` `macOS`