Merged PR 496581: Universal Packages wildcard docs

Universal Packages wildcard docs

Related work items: #1350543

docs/artifacts/quickstarts/universal-packages.md

@@ -8,7 +8,7 @@ ms.topic: conceptual
 ms.manager: jillfra
 ms.author: phwilson
 author: chasewilson
-ms.date: 09/25/2018
+ms.date: 08/16/2019
 monikerRange: 'azure-devops'
 ---
 
@@ -165,6 +165,19 @@ az artifacts universal download --organization https://fabrikam.visualstudio.com
 
 ---
 
+### Downloading the latest version
+
+When downloading a Universal Package, you can use a wildcard expression in the `version` parameter to download the highest version of a package according to [Semantic Versioning](https://semver.org) precedence rules.  
+
+#### Examples
+`*`: Highest version  
+`1.*`: Highest version with major version `1`  
+`1.2.*`: Highest patch release with major version `1` and minor version `2`  
+
+Wildcard expressions do not currently support pre-release versions. It is not possible to get the latest pre-release version of a package.  
+
+Note that while Semantic Versioning specifies that versions must increase over time, Azure Artifacts does not enforce this rule. As such, the highest matching version that will be downloaded is not necessarily the most recently published version.
+
 ## Next steps
 
 In this quickstart, you published your first Universal Package and then downloaded back to your machine. To learn more about the Universal Package CLI, append `-h` to any CLI command. To use Universal Packages in a build, see the [Azure Pipelines doc for Universal Packages](../../pipelines/artifacts/universal-packages.md).

docs/pipelines/artifacts/universal-packages.md

@@ -11,7 +11,7 @@ ms.topic: conceptual
 ms.manager: jillfra
 ms.author: phwilson
 author: chasewilson
-ms.date: 08/06/2018
+ms.date: 08/16/2019
 monikerRange: 'azure-devops'
 ---
 
@@ -136,8 +136,8 @@ steps:
     command: download
     feedsToUse: external
     externalFeedCredentials: MSENG2
-    feedDownloadExternal: `fabrikamFeedExternal`
-    packageDownloadExternal: `fabrikam-package`
+    feedDownloadExternal: 'fabrikamFeedExternal'
+    packageDownloadExternal: 'fabrikam-package'
     versionDownloadExternal: 1.0.0
 ```
 
@@ -165,6 +165,11 @@ To download a Universal Package, add the **Universal Package** task and configur
 ![Example Download Universal Packages build step screenshot](_img/universal-packages/download.png)
 
 * * *
+
+### Downloading the latest version
+
+You can use a wildcard expression as the version to get the latest (highest) version of a package. For more information, see [Downloading the latest version](../../artifacts/quickstarts/universal-packages.md#downloading-the-latest-version) in the quickstart guide.
+
 ## Q&A
 
 ### Where can I learn more about Azure Artifacts and the TFS Package Management service?