Add XD 22 & 23 release notes

Add docs describing textfield Enter/Escape behavior.
Add warning that additional interaction trigger/action types may be coming.
Few more minor fixes.

Author: peterflynn

changes.md

@@ -1,6 +1,41 @@
 # Change Log
 
-## XD Release 21.0.12 (July 2019)
+XD Release 23.1.32 (October 2019)
+-------------------------------------
+
+### New plugin listing process
+Information shown in the plugin listing has moved out of `manifest.json` and is instead provided online when you submit a plugin to the listing.
+
+* Submitting a plugin also now requires at least one _screenshot image_.
+* Icons seen in the Plugin Manager list must be provided online during submission, but icons seen in the Plugins side panel must still be part of the plugin package folder.
+* As of XD 23, the Plugin Manager UI ignores description, author, links, etc. in `manifest.json`. Submitting to the public listing is now the _only_ way to display this info in Plugin Manager. See [updated manifest documentation](./reference/structure/manifest.md).
+* As of September 24, submitting a new or updated plugin to the public listing requires supplying all these details via the developer submission portal online. See [How to submit to Plugin Manager](distribution/how-to-submit-to-plugin-manager.md).
+
+### Smaller fixes and improvements
+* Clarified that `editDocument()` does not support the `mergeId` option for UI events that are not "high frequency."
+* Can `preventDefault()` on Esc or Enter in text fields to prevent the default action of sending focus back to the canvas.
+* Fixed bug with setting opacity of BooleanGroup nodes.
+* Plugin Manager UI shows plugins that were disabled because they're incompatible with the current version of XD, with tooltip explaining why.
+
+
+----
+
+XD Release 22.0.12 (August 2019)
+----------------------------------
+
+After a stabilization period, plugins using panel UI are now published in the Plugin Manager listing!
+
+### Fixes and improvements
+
+* Fixed bugs related to `editDocument()` usage (also fixed in XD 21.1.12).
+* PUT/POST requests on Windows were including an unwanted `Transfer-Encoding` header, which interfered with uploading data to services like Amazon S3.
+* Plugins can now copy text to the clipboard in response to a panel UI DOM event without needing to call `editDocument()`.
+
+
+----
+
+XD Release 21.0.12 (July 2019)
+----------------------------------
 
 XD 21 adds major updates: the ability to **show panel UI**, and the much-improved **UXP 3 CSS & layout engine**.
 
@@ -61,7 +96,8 @@ See the [Known Issues page](./known-issues.md) for a comprehensive list of exist
 
 ----
 
-## XD Release 20.0.12 (June 2019)
+XD Release 20.0.12 (June 2019)
+----------------------------------
 
 ### UI Changes
 
@@ -88,7 +124,8 @@ No new known issues. See the [Known Issues page](./known-issues.md) for a compre
 
 ----
 
-## XD Release 19.0.12 (May 2019)
+XD Release 19.0.12 (May 2019)
+----------------------------------
 
 ### New API Features
 
@@ -127,7 +164,8 @@ No new known issues. See the [Known Issues page](./known-issues.md) for a compre
 
 ----
 
-## XD Release 18.0.12 (April 2019)
+XD Release 18.0.12 (April 2019)
+----------------------------------
 
 ### New API Features
 
@@ -186,7 +224,8 @@ No new known issues. See the [Known Issues page](./known-issues.md) for a compre
 
 ----
 
-## XD Release 17.0.12 (March 2019)
+XD Release 17.0.12 (March 2019)
+----------------------------------
 
 ### New API Features
 
@@ -220,7 +259,8 @@ No new known issues. See the [Known Issues page](./known-issues.md) for a compre
 
 ----
 
-## XD Release 16.0.12 (February 2019)
+XD Release 16.0.12 (February 2019)
+----------------------------------
 
 ### New API Features
 
@@ -243,7 +283,8 @@ No new known issues. See the [Known Issues page](./known-issues.md) for a compre
 
 ----
 
-## XD Release 15.0.12 (January 2019)
+XD Release 15.0.12 (January 2019)
+----------------------------------
 
 ### New API Features
 
@@ -275,7 +316,8 @@ See the [Known Issues page](./known-issues.md) for a comprehensive list of exist
 
 ----
 
-## XD Release 14.0.42 (December 2018)
+XD Release 14.0.42 (December 2018)
+----------------------------------
 
 ### New API Features
 
@@ -309,6 +351,7 @@ No new known issues. See the [Known Issues page](./known-issues.md) for a compre
 
 ----
 
-## XD Release 13.0.12 (October 2018)
+XD Release 13.0.12 (October 2018)
+----------------------------------
 
-This was the first release of Adobe XD featuring a public API for in-app plugins!
+First release of Adobe XD featuring a public API for in-app plugins!

distribution/how-to-submit-to-plugin-manager.md

@@ -51,7 +51,7 @@ The "Submit plugin for review" page has two tabs: "Listing information" and "Plu
 
 Next, indicate whether your plugin requires installations of another application or use of a third party service. Also, include release notes for this version. This information will be displayed in the plugin manager to help users onboard your plugin.
 
-![Publisher and plugin info](/images/connect-and-version-details.png)
+![Connection and version info](/images/connect-and-version-details.png)
 
 Next, you are asked to provide three plugin icons (48 x 48 px, 96 x 96 px, and 192 x 192 px). These icons will be used for display in the Plugin Manager listing.
 
@@ -60,7 +60,7 @@ Next, you are asked to provide three plugin icons (48 x 48 px, 96 x 96 px, and 1
 
 You must also provide at least one screenshot of your plugin, which will be included in your Plugin Manager listing when published.
 
-![Publisher and plugin info](/images/plugin-icons-and-screenshots.png)
+![Icon and screenshot info](/images/plugin-icons-and-screenshots.png)
 
 Finally, if you have a message for our reviewers, write it here. 
 

reference/cloud.md

@@ -6,6 +6,7 @@ The `cloud` module lets you get information about shared prototypes and design s
 **Example**
 ```js
 // Get prototypes data
+const cloud = require("cloud");
 var sharedArtifacts = cloud.getSharedArtifacts();
 var prototypes = sharedArtifacts.filter(artifact => (artifact.type === cloud.ArtifactType.PROTOTYPE));
 prototypes.forEach(artifact => {
@@ -16,6 +17,7 @@ prototypes.forEach(artifact => {
 **Example**
 ```js
 // Get design specs data
+const cloud = require("cloud");
 var sharedArtifacts = cloud.getSharedArtifacts();
 var specs = sharedArtifacts.filter(artifact => (artifact.type === cloud.ArtifactType.SPECS));
 specs.forEach(artifact => {
@@ -64,7 +66,7 @@ Properties common to both types.
 
 | Property | Type | Description |
 | --- | --- | --- |
-| type | ArtifactType | Set to `ArtifactType.PROTOTYPE` |
+| type | ArtifactType | Type of shared artifact |
 | url | string | URL to view in browser |
 | name | string | Name of shared artifact (often, but not always, matches the document name) |
 | accessLevel | AccessLevel | Level of access protection |

reference/interactions.md

@@ -75,7 +75,8 @@ An interaction consists of a Trigger + Action pair and is attached to a single,
 }
 ```
 
-Note: Interaction objects are _not_ plain JSON -- they may reference scenenodes (as seen above) and other strongly-typed objects.
+> **Tip**
+> Note: Interaction objects are _not_ plain JSON -- they may reference scenenodes (as seen above) and other strongly-typed objects.
 
 <a name="Trigger" id="Trigger"></a>
 
@@ -86,6 +87,10 @@ Event which triggers an interaction.
 | --- | --- | --- |
 | type | string | One of the trigger types listed below. |
 
+> **Tip**
+> Note: Additional trigger types may be added in the future. Always be sure to have a default case for unknown triggers when
+> working with Interaction objects.
+
 ##### "tap"
 When the user clicks or taps on a scenenode.
 
@@ -109,12 +114,16 @@ When the user speaks a specific voice command. Additional Trigger properties:
 <a name="Action" id="Action"></a>
 
 ### Typedef Action
-Action performed when the trigger occurs. Current action types are:
+Action performed when the trigger occurs.
 
 | Property | Type | Description |
 | --- | --- | --- |
 | type | string | One of the action types listed below. |
 
+> **Tip**
+> Note: Additional action types may be added in the future. Always be sure to have a default case for unknown actions when
+> working with Interaction objects.
+
 ##### "goToArtboard"
 Navigate the entire screen to view a different artboard. Additional Action properties:
 

reference/scenegraph.md

@@ -46,8 +46,9 @@ function myCommand(selection) {
 
 ## Class hierarchy
 
-Note: Additional subclasses may be added in the future. Always be sure to have a default case for unknown scenenode classes
-when traversing the scenegraph.
+> **Tip**
+> Note: Additional subclasses may be added in the future. Always be sure to have a default case for unknown scenenode classes
+> when traversing the scenegraph.
 
 * [SceneNode](#SceneNode)
     * [GraphicNode](#GraphicNode)

reference/ui/elements/textfields.md

@@ -116,6 +116,15 @@ Default text value here
 
 -->
 
+## Behavior
+
+##### In panel UI
+* When the user presses Escape or Enter in a text field, keyboard focus is sent back to the design canvas. You can prevent this by calling `preventDefault()` on the `keydown` event.
+* To return keyboard focus to the design canvas programmatically, call `blur()` on whichever text field in your panel UI is currently focused.
+
+##### In dialog boxes
+* Pressing Escape in any text field closes the dialog, resolving `showModal()`'s Promise with the string `"reasonCanceled"`. This cannot be prevented.
+
 ## Guidelines
 
 ##### Include a Label