Merge pull request #24538 from olivertowers/patch-2

Azure CosmosDB Graph SDK 0.3.0-preview release notes

Author: v-thepet

articles/cosmos-db/graph-sdk-dotnet.md

@@ -25,10 +25,40 @@ ms.author: mimig
 |**API documentation**|[.NET API reference documentation](https://aka.ms/acdbgraphapiref)|
 |**Quickstart**|[Azure Cosmos DB: Create a graph app using .NET and the Graph API](create-graph-dotnet.md)|
 |**Tutorial**|[Azure CosmosDB: Create a container with the Graph API](tutorial-develop-graph-dotnet.md)|
-|**Current supported framework**|[Microsoft .NET Framework 4.5](https://www.microsoft.com/download/details.aspx?id=30653)|
+|**Current supported framework**| [Microsoft .NET Framework 4.6.1](https://www.microsoft.com/en-us/download/details.aspx?id=49981)</br> [Microsoft .NET Core](https://www.microsoft.com/net/download/core) |
+
 
 ## Release notes
 
+### <a name="0.3.0-preview"/>0.3.0-preview
+
+#### What's new
+* Added support for `.netstandard 1.6`
+  * Requires `Microsoft.Azure.DocumentDB.Core >= 1.5.1`
+* Added a new `gremlin-groovy` parser to replace existing parser. This parser supports a subset of Tinkerpop's `gremlin-groovy` syntax and includes:
+  * Improved parsing performance by 2x.
+  * Resolved a number of issues related to character escaping in strings, incorrectly handled literal values, and other irregularities in the old parser.
+* Added optimizations for traversals with edge predicates.
+  *  Traversal hops with filters should see this improvement, for example: `g.V('1').outE().has('name', 'marko').inV()`.
+* Added optimizations for traversals with `limit()` step.
+
+#### Breaking Changes
+* Removed support for .NET Framework 4.5.1
+
+* The new parser aligns with `gremlin-groovy` grammar. As a result, some expressions that worked previously are ambiguous for the new parser. One case of note:
+  * `in` and `as` are reserved keywords in `gremlin-groovy`, so these steps must be qualified with `.in()` or `.as()` to avoid syntax errors. For example:
+ `g.V().repeat(in()).times(2)` -> _throws a syntax error_  
+ `g.V().repeat(__.in()).times(2)` -> _succeeds_
+
+### <a name="0.2.4-preview"/>0.2.4-preview
+
+### <a name="0.2.2-preview"/>0.2.2-preview
+
+### <a name="0.2.1-preview"/>0.2.1-preview
+
+### <a name="0.2.0-preview"/>0.2.0-preview
+
+### <a name="0.1.0-preview"/>0.1.0-preview
 * Initial preview release.
 
 ## Release & Retirement dates
@@ -38,5 +68,16 @@ New features and functionality and optimizations are only added to the current S
 
 Any request to Azure Cosmos DB using a retired SDK will be rejected by the service.
 
+<br/>
+
+| Version | Release Date | Retirement Date |
+| --- | --- | --- |
+| [0.3.0-preview](#0.3.0-preview) |October 2, 2017 |--- |
+| [0.2.4-preview](#0.2.4-preview) |August 4, 2017 |--- |
+| [0.2.2-preview](#0.2.2-preview) |June 23, 2017 |--- |
+| [0.2.1-preview](#0.2.2-preview) |June 8, 2017 |--- |
+| [0.2.0-preview](#0.2.2-preview) |May 10, 2017 |--- |
+| [0.1.0-preview](#0.1.0-preview) |May 8, 2017 |--- |
+
 ## See also
-To learn more about the Azure Cosmos DB Graph API, see [Introduction to Azure Cosmos DB: Graph API](graph-introduction.md). 
+To learn more about the Azure Cosmos DB Graph API, see [Introduction to Azure Cosmos DB: Graph API](graph-introduction.md).