XD 25 changelog and docs polish

Author: peterflynn

changes.md

@@ -1,5 +1,14 @@
 # Change Log
 
+XD Release 25.1.12 (December 2019)
+-------------------------------------
+
+XD 25 is a minor bug-fix release with no new features for end users. But it adds two small improvements for plugins:
+
+* New [`application.activeDocument` API](./reference/application.md#module_application-activeDocument) providing information about the document.
+* Fixed bug where `scenegraph.root.guid` did not return a valid guid; it now returns the same value as `application.activeDocument.guid`.
+
+
 XD Release 24.0.22 (November 2019)
 -------------------------------------
 
@@ -71,7 +80,7 @@ After a stabilization period, plugins using panel UI are now published in the Pl
 ### 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.
+* PUT/POST requests on Windows were including an unwanted `Transfer-Encoding` header, which interfered with uploading data to services like Amazon S3 (e.g. giving you errors related to `Content-Length`).
 * Plugins can now copy text to the clipboard in response to a panel UI DOM event without needing to call `editDocument()`.
 
 

reference/application.md

@@ -186,22 +186,26 @@ console.log("OS locale:", application.systemLocale); // e.g. "en_US"
 
 ### *application.activeDocument : <code>DocumentInfo</code>*
 
-Represents the active document. Provides the document guid and current saved name.
+Information about the document which this instance of the plugin is attached to.
+
+> **Tip**
+> _This does **not** indicate the frontmost "active" document window in the XD application._
+> In XD, each document window [loads a separate copy of your plugin](./core/lifecycle.md#plugin-loading). When a given instance of your plugin calls this API, you will always receive information about the document that this instance of the plugin is attached to, even if it's not the active window.
 
 **Kind**: static property of [<code>application</code>](#module_application)  
 **Read only**: true  
 
 **Typedef DocumentInfo**
 
-| Property   | Type              | Description                                        |
-| ---------- | ----------------- | ---------------------------------------------------|
-| name       | string            | Document name as displayed in the document window. |
-| guid       | string            | Unique document identifier that does not change.   |
+| Property   | Type       | Description                                         |
+| ---------- | ---------- | --------------------------------------------------- |
+| name       | string     | Document name as displayed in the titlebar. For untitled documents, this will be a localized string such as "Untitled-1." |
+| guid       | string     | *Semi*-unique document identifier. Duplicating an .xd file on disk will result in two files with the same GUID. Duplicating a document via "Save As" will change its GUID; thus two *cloud* documents will never have the same GUID. The GUID of an Untitled document doesn't change when it is saved for the first time. <br><br>This returns the same value as `scenegraph.root.guid`. |
 
 **Example**
 ```js
-var application = require("application");
+let application = require("application");
 let documentInfo = application.activeDocument;
-console.log(“Document title: ” + documentInfo.name);
-console.log(“Document unique Id: ” + documentInfo.guid);
+console.log("Document title: " + documentInfo.name);
+console.log("Document ID: " + documentInfo.guid);
 ```

reference/scenegraph.md

@@ -167,6 +167,8 @@ Base class of all scenegraph nodes. Nodes will always be an instance of some _su
 ### *sceneNode.guid : <code>string</code>*
 Returns a unique identifier for this node that stays the same when the file is closed & reopened, or if the node is moved to a different part of the document. Cut-Paste will result in a new guid, however.
 
+The GUID of the [root node](#module_scenegraph-root) changes if the document is duplicated via Save As. See [`application.activeDocument.guid`](./application.md#module_application-activeDocument) for details.
+
 **Kind**: instance property of [<code>SceneNode</code>](#SceneNode)
 **Read only**: true