Review

Author: quinntracy

content/en/docs/apidocs-mxsdk/apidocs/studio-pro-11/extensibility-api/web/web-extensions-howtos/permissions.md

@@ -54,10 +54,10 @@ When a user installs an extension that requests permissions, they can manage tho
 
 ## Reacting to Permission Changes
 
-Extensions can subscribe to the `permissionsChanged` event on `IExtensionPermissionsApi` to be notified whenever the user grants or revokes permissions for any of the extensions. This allows you to reactively update your extension's behaviour without requiring a restart.
+Extensions can subscribe to the `permissionsChanged` event on `IExtensionPermissionsApi` to be notified whenever the user grants or revokes permissions for any extension. This allows you to reactively update your extension's behavior without requiring a restart.
 
 The event carries no arguments. When it fires, call `getPermissions()` to retrieve the current state.
-Update you main/index.ts to the following to check when someone unchecked the permissions.
+Update your `main/index.ts` to the following to detect when a permission changes.
 
 ```typescript
 import { IComponent, getStudioProApi } from "@mendix/extensions-api";
@@ -90,10 +90,9 @@ export const component: IComponent = {
     }
 };
 ```
-The `permissionsChanged` event fires for all extensions whenever any permission is granted or revoked anywhere in the system, not just for your extension. This means multiple extensions may be responding to the same event simultaneously.
+The `permissionsChanged` event fires for all extensions whenever any permission is granted or revoked anywhere in the system, not just for your extension. This means multiple extensions may respond to the same event simultaneously.
 
-To check if the change happened for your extension you must compare the old granted state against the new one for the permission name you want to be granted.
-Without this check, your extension would fire a notification every time any extension's permission changes, even ones completely unrelated to you.
+To check if a change affects your extension, compare the old granted state against the new one for each permission name your extension declared. Without this check, your extension fires a notification every time any permission changes, including changes unrelated to your extension.
 
 ## Available Permissions
 

content/en/docs/apidocs-mxsdk/apidocs/studio-pro-11/extensibility-api/web/web-extensions-howtos/preference-api.md

@@ -25,6 +25,10 @@ Create a menu that displays a dialog with text in the `loaded` method in the mai
 
 In the example below, you create one menu item that shows a message box with the user's preferences, such as `Light` or `Dark` mode, current language and the version of Studio Pro the user is using.
 
+{{% alert type="info" %}}
+Seeing the current Studio Pro version is available for Studio Pro 11.12 and above.
+{{% /alert %}} 
+
 Replace your `src/main/index.ts` file with the following:
 
 ```typescript

content/en/docs/releasenotes/studio-pro/web-extensibility-api.md

@@ -10,9 +10,9 @@ These release notes cover changes to the [Extensibility API for Web Developers](
 
 ## Version 11.12.0
 
-* We added a `permissionsChanged` event that can help you know if the user changed the permissions of your extensions in the [Permissions API] (/apidocs-mxsdk/apidocs/web-extensibility-api-11/extension-permissions/)
-* We added the `documentsChanged` event for when one of your dependencies gets modified in Studio Pro and is a dependency you can get notified.
-* The version of the studio pro is available though the [Preferences API](/apidocs-mxsdk/apidocs/web-extensibility-api-11/preference-api/).
+* We added a `permissionsChanged` event to the [Permissions API](/apidocs-mxsdk/apidocs/web-extensibility-api-11/extension-permissions/) that notifies you when the user changes the permissions of your extension.
+* We added the `documentsChanged` event, which notifies you when a document that your extension depends on is modified in Studio Pro.
+* The Studio Pro version is now available through the [Preferences API](/apidocs-mxsdk/apidocs/web-extensibility-api-11/preference-api/).
 
 ## Version 11.11.0