dotnet · CESARDELATORRE · Oct 14, 2017 · Oct 14, 2017 · Oct 17, 2017 · Oct 14, 2017
diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json
@@ -904,6 +904,11 @@
             "redirect_url": "/dotnet/standard/net-standard",
             "redirect_document_id": true
         },
+        {
+            "source_path": "docs/standard/microservices-architecture/architect-microservice-container-applications/communication-between-microservices.md",
+            "redirect_url": "/dotnet/standard/microservices-architecture/architect-microservice-container-applications/communication-in-microservice-architecture",
+            "redirect_document_id": true
+        },        
         {
             "source_path": "docs/standard/serialization/marshal-by-value.md",
             "redirect_url": "/dotnet/standard/serialization-concepts"

diff --git a/api/index.md b/api/index.md
@@ -2,7 +2,7 @@
 layout: ApiBrowserPage
 hide_bc: true
 title: .NET API Browser
-quickFilterColumn1: netframework-4.7,netcore-2.0,netstandard-2.0
+quickFilterColumn1: netframework-4.7.1,netcore-2.0,netstandard-2.0
 quickFilterColumn2: xamarinios-10.8,xamarinandroid-7.1,xamarinmac-3.0
 quickFilterColumn3: azuremgmtresourcemanager-1.5.0-preview,appinsights-2.3.0-beta3,aspnetcore-2.0
 ---

diff --git a/docs/core/deploying/runtime-store.md b/docs/core/deploying/runtime-store.md
@@ -81,9 +81,9 @@ The following *artifact.xml* file is produced after running the previous example
 
 ```xml
 <StoreArtifacts>
-  <Package Id="newtonsoft.json" Version="10.0.3" />
-  <Package Id="castle.core" Version="4.1.0" />
-  <Package Id="moq" Version="4.7.63" />
+  <Package Id="Newtonsoft.Json" Version="10.0.3" />
+  <Package Id="Castle.Core" Version="4.1.0" />
+  <Package Id="Moq" Version="4.7.63" />
 </StoreArtifacts>
 ```
 

diff --git a/docs/core/windows-prerequisites.md b/docs/core/windows-prerequisites.md
@@ -35,7 +35,7 @@ See [.NET Core 1.x Supported OS Versions](https://github.com/dotnet/core/blob/ma
 
 .NET Core 1.1 and earlier requires the Visual C++ Redistributable when running on Windows versions earlier than Windows 10 and Windows Server 2016. This dependency is automatically installed by the .NET Core installer.
 
-[Microsoft Visual C++ 2015 Redistributable Update 3](https://www.microsoft.com/en-us/download/details.aspx?id=52685) must be manually installed when:
+[Microsoft Visual C++ 2015 Redistributable Update 3](https://www.microsoft.com/download/details.aspx?id=52685) must be manually installed when:
 
    * Installing .NET Core with the [installer script](./tools/dotnet-install-script.md).
    * Deploying a self-contained .NET Core application.

diff --git a/docs/csharp/language-reference/keywords/interpolated-strings.md b/docs/csharp/language-reference/keywords/interpolated-strings.md
@@ -1,6 +1,6 @@
 ---
 title: "Interpolated Strings (C#)"
-ms.date: "09/27/2017"
+ms.date: "10/18/2017"
 ms.prod: .net
 ms.technology: 
   - "devlang-csharp"
@@ -17,12 +17,12 @@ Used to construct strings.  An interpolated string looks like a template string
 The arguments of an interpolated string are easier to understand than a [composite format string](../../../standard/base-types/composite-formatting.md#composite-format-string).  For example, the interpolated string  
 
 ```csharp  
-Console.WriteLine($"Name = {name}, hours = {date:hh}"); 
+Console.WriteLine($"Name = {name}, hours = {hours:hh}");
 ```  
-contains two interpolated expressions, '{name}' and '{date:hh}'. The equivalent composite format string is:
+contains two interpolated expressions, '{name}' and '{hour:hh}'. The equivalent composite format string is:
 
 ```csharp
-Console.WriteLine("Name = {0}, hours = {1:hh}", name, date);  
+Console.WriteLine("Name = {0}, hours = {1:hh}", name, hours); 
 ```  
 
 The structure of an interpolated string is:  
@@ -48,7 +48,7 @@ If the interpolated string contains other characters with special meaning in an
 
 [!code-cs[interpolated-strings4](../../../../samples/snippets/csharp/language-reference/keywords/interpolated-strings4.cs#1)]  
 
-Verbatim interpolated strings use the `$` character followed by the `@` character. For more information about verbatim strings, see the [string](strings.md) topic. The following code is a modified version of the previous snippet using a verbatim interpolated string:
+Verbatim interpolated strings use the `$` character followed by the `@` character. For more information about verbatim strings, see the [string](string.md) topic. The following code is a modified version of the previous snippet using a verbatim interpolated string:
 
 [!code-cs[interpolated-strings4](../../../../samples/snippets/csharp/language-reference/keywords/interpolated-strings5.cs#1)]  
 

diff --git a/docs/csharp/language-reference/preprocessor-directives/preprocessor-if.md b/docs/csharp/language-reference/preprocessor-directives/preprocessor-if.md
@@ -44,7 +44,8 @@ When the C# compiler encounters an `#if` directive, followed eventually by an [#
 
 ```csharp
 // preprocessor_if.cs  
-#define DEBUG#define MYTEST  
+#define DEBUG
+#define MYTEST  
 using System;  
 public class MyClass   
 {  

diff --git a/docs/csharp/misc/cs0636.md b/docs/csharp/misc/cs0636.md
@@ -17,7 +17,7 @@ ms.author: "wiwagn"
 # Compiler Error CS0636
 The FieldOffset attribute can only be placed on members of types marked with the StructLayout(LayoutKind.Explicit)  
 
- You must use the **StructLayout(LayoutKind.Explicit)** attribute on the struct declaration, if it contains any members marked with the **FieldOffset** attribute. For more information, see [FieldOffset](xref:System.Runtime.InteropServices.FieldOffsetAttribute).  
+ You must use the **StructLayout(LayoutKind.Explicit)** attribute on the struct declaration, if it contains any members marked with the **FieldOffset** attribute. For more information, see [FieldOffset](xref:System.Runtime.InteropServices.FieldOffsetAttribute).  
 
  The following sample generates CS0636:  
 

diff --git a/...rogramming-guide/classes-and-structs/codesnippet/CSharp/named-and-optional-arguments_1.cs b/...rogramming-guide/classes-and-structs/codesnippet/CSharp/named-and-optional-arguments_1.cs
@@ -3,22 +3,32 @@ class NamedExample
         static void Main(string[] args)
         {
             // The method can be called in the normal way, by using positional arguments.
-            Console.WriteLine(CalculateBMI(123, 64));
+            PrintOrderDetails("Gift Shop", 31, "Red Mug");
 
-            // Named arguments can be supplied for the parameters in either order.
-            Console.WriteLine(CalculateBMI(weight: 123, height: 64));
-            Console.WriteLine(CalculateBMI(height: 64, weight: 123));
+            // Named arguments can be supplied for the parameters in any order.
+            PrintOrderDetails(orderNum: 31, productName: "Red Mug", sellerName: "Gift Shop");
+            PrintOrderDetails(productName: "Red Mug", sellerName: "Gift Shop", orderNum: 31);
 
-            // Positional arguments cannot follow named arguments.
-            // The following statement causes a compiler error.
-            //Console.WriteLine(CalculateBMI(weight: 123, 64));
+            // Named arguments mixed with positional arguments are valid
+            // as long as they are used in their correct position.
+            PrintOrderDetails("Gift Shop", 31, productName: "Red Mug");
+            PrintOrderDetails(sellerName: "Gift Shop", 31, productName: "Red Mug");    // C# 7.2 onwards
+            PrintOrderDetails("Gift Shop", orderNum: 31, "Red Mug");                   // C# 7.2 onwards
 
-            // Named arguments can follow positional arguments.
-            Console.WriteLine(CalculateBMI(123, height: 64));
+            // However, mixed arguments are invalid if used out-of-order.
+            // The following statements will cause a compiler error.
+            // PrintOrderDetails(productName: "Red Mug", 31, "Gift Shop");
+            // PrintOrderDetails(31, sellerName: "Gift Shop", "Red Mug");
+            // PrintOrderDetails(31, "Red Mug", sellerName: "Gift Shop");
         }
 
-        static int CalculateBMI(int weight, int height)
+        static void PrintOrderDetails(string sellerName, int orderNum, string productName)
         {
-            return (weight * 703) / (height * height);
+            if (string.IsNullOrWhiteSpace(sellerName))
+            {
+                throw new ArgumentException(message: "Seller name cannot be null or empty.", paramName: nameof(sellerName));
+            }
+
+            Console.WriteLine($"Seller: {sellerName}, Order #: {orderNum}, Product: {productName}");
         }
-    }
+    }
diff --git a/docs/csharp/programming-guide/classes-and-structs/named-and-optional-arguments.md b/docs/csharp/programming-guide/classes-and-structs/named-and-optional-arguments.md
@@ -29,28 +29,37 @@ ms.author: "wiwagn"
  Named and optional parameters, when used together, enable you to supply arguments for only a few parameters from a list of optional parameters. This capability greatly facilitates calls to COM interfaces such as the Microsoft Office Automation APIs.  
 
 ## Named Arguments  
- Named arguments free you from the need to remember or to look up the order of parameters in the parameter lists of called methods. The parameter for each argument can be specified by parameter name. For example, a function that calculates body mass index (BMI) can be called in the standard way by sending arguments for weight and height by position, in the order defined by the function.  
+ Named arguments free you from the need to remember or to look up the order of parameters in the parameter lists of called methods. The parameter for each argument can be specified by parameter name. For example, a function that prints order details (such as, seller name, order number & product name) can be called in the standard way by sending arguments by position, in the order defined by the function.
 
- `CalculateBMI(123, 64);`  
+ `PrintOrderDetails("Gift Shop", 31, "Red Mug");`
 
- If you do not remember the order of the parameters but you do know their names, you can send the arguments in either order, weight first or height first.  
+ If you do not remember the order of the parameters but know their names, you can send the arguments in any order.  
 
- `CalculateBMI(weight: 123, height: 64);`  
+ `PrintOrderDetails(orderNum: 31, productName: "Red Mug", sellerName: "Gift Shop");`
 
- `CalculateBMI(height: 64, weight: 123);`  
+ `PrintOrderDetails(productName: "Red Mug", sellerName: "Gift Shop", orderNum: 31);`
 
- Named arguments also improve the readability of your code by identifying what each argument represents.  
+ Named arguments also improve the readability of your code by identifying what each argument represents. In the example method below, the `sellerName` cannot be null or whitespace. As both `sellerName` and `productName` are string types, instead of sending arguments by position, it makes sense to use named arguments to disambiguate the two and reduce confusion for anyone reading the code.
 
- A named argument can follow positional arguments, as shown here.  
+ Named arguments, when used with positional arguments, are valid as long as 
+
+- they're not followed by any positional arguments, or
+
+ `PrintOrderDetails("Gift Shop", 31, productName: "Red Mug");`
+
+- _starting with C# 7.2_, they're used in the correct position. In the example below, the parameter `orderNum` is in the correct position but isn't explicitly named.
+
+ `PrintOrderDetails(sellerName: "Gift Shop", 31, productName: "Red Mug");`
 
- `CalculateBMI(123, height: 64);`  
-
- However, a positional argument cannot follow a named argument. The following statement causes a compiler error.  
-
- `//CalculateBMI(weight: 123, 64);`  
+ However, out-of-order named arguments are invalid if they're followed by positional arguments.
+
+ ```csharp
+ // This generates CS1738: Named argument specifications must appear after all fixed arguments have been specified.
+ PrintOrderDetails(productName: "Red Mug", 31, "Gift Shop");
+ ```
 
 ## Example  
- The following code implements the examples from this section.  
+ The following code implements the examples from this section along with some additional ones.  
 
  [!code-cs[csProgGuideNamedAndOptional#1](../../../csharp/programming-guide/classes-and-structs/codesnippet/CSharp/named-and-optional-arguments_1.cs)]  
 

diff --git a/docs/csharp/tutorials/console-teleprompter.md b/docs/csharp/tutorials/console-teleprompter.md
@@ -105,7 +105,7 @@ using System.IO;
 ```
 
 The `IEnumerable<T>` interface is defined in the 
-`System.Collections.Generic` namespace. The @System.IO.File class is defined in the
+`System.Collections.Generic` namespace. The <xref:System.IO.File> class is defined in the
 `System.IO` namespace.
 
 This method is a special type of C# method called an *Enumerator method*. 
@@ -123,7 +123,7 @@ indicates that there are no more items.
 There are two other C# syntax elements that may be new to you. The `using` 
 statement in this method manages resource cleanup. The variable that is
 initialized in the `using` statement (`reader`, in this example) must
-implement the `IDisposable` interface. The @System.IDisposable interface
+implement the `IDisposable` interface. The <xref:System.IDisposable> interface
 defines a single method, `Dispose`, that should be called when the
 resource should be released. The compiler generates that call when
 execution reaches the closing brace of the `using` statement. The
@@ -134,8 +134,8 @@ statement.
 The `reader` variable is defined using the `var` keyword. `var` defines an
 *implicitly typed local variable*. That means the type of the variable is
 determined by the compile time type of the object assigned to the
-variable. Here, that is the return value from @System.IO.File.OpenText, which is
-a @System.IO.StreamReader object.
+variable. Here, that is the return value from the <xref:System.IO.File.OpenText(System.String)> method, which is
+a <xref:System.IO.StreamReader> object.
 
 Now, let’s fill in the code to read the file in the `Main` method: 
 
@@ -228,7 +228,7 @@ In this final step, you’ll add the code to write the output asynchronously
 in one task, while also running another task to read input from the user
 if they want to speed up or slow down the text display. This has a few
 steps in it and by the end, you’ll have all the updates that you need.
-The first step is to create an asynchronous @System.Threading.Tasks.Task returning method that
+The first step is to create an asynchronous <xref:System.Threading.Tasks.Task> returning method that
 represents the code you’ve created so far to read and display the file.
 
 Add this method to your `Program` class (it’s taken from the body of your
@@ -250,7 +250,7 @@ private static async Task ShowTeleprompter()
 ```
 
 You’ll notice two changes. First, in the body of the method, instead of
-calling @System.Threading.Tasks.Task.Wait to synchronously wait for a task to finish, this version
+calling <xref:System.Threading.Tasks.Task.Wait> to synchronously wait for a task to finish, this version
 uses the `await` keyword. In order to do that, you need to add the `async`
 modifier to the method signature. This method returns a `Task`. Notice that
 there are no return statements that return a `Task` object. Instead, that
@@ -300,9 +300,9 @@ private static async Task GetInput()
 }
 ```
 
-This creates a lambda expression to represent an @System.Action delegate that reads a key
+This creates a lambda expression to represent an <xref:System.Action> delegate that reads a key
 from the Console and modifies a local variable representing the delay when
-the user presses the ‘<’ or ‘>’ keys. This method uses @System.Console.ReadKey
+the user presses the ‘<’ or ‘>’ keys. This method uses <xref:System.Console.ReadKey>
 to block and wait for the user to press a key.
 
 To finish this feature, you need to create a new `async Task` returning
@@ -368,7 +368,7 @@ private static async Task RunTeleprompter()
 }
 ```
 
-The one new method here is the @System.Threading.Tasks.Task.WhenAny(System.Threading.Tasks.Task[]) call. That creates a `Task`
+The one new method here is the <xref:System.Threading.Tasks.Task.WhenAny(System.Threading.Tasks.Task[])> call. That creates a `Task`
 that finishes as soon as any of the tasks in its argument list completes.
 
 Next, you need to update both the `ShowTeleprompter` and `GetInput` methods to

diff --git a/docs/framework/get-started/system-requirements.md b/docs/framework/get-started/system-requirements.md
@@ -71,6 +71,7 @@ The .NET Framework requires administrator privileges for installation. If you do
 
 | Operating system | Supported editions | Preinstalled with the OS | Installable separately |
 | ---------------- | ------------------ | ------------------------ | ---------------------- |
+| Windows Server, version 1709 | 64-bit | .NET Framework 4.7.1 | -- |
 | Windows Server 2016 | 64-bit | [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] | .NET Framework 4.7<br/><br/> .NET Framework 4.7.1 |
 | Windows Server 2012 R2 | 64-bit | [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] | [!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]<br /><br /> [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]<br /><br />.NET Framework 4.7<br/><br/> .NET Framework 4.7.1 |
 | Windows Server 2012 (64-bit edition) | 64-bit| [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] | [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]<br /><br /> [!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]<br /><br /> [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]<br /><br />.NET Framework 4.7<br/><br/>.NET Framework 4.7.1 |

diff --git a/docs/framework/install/guide-for-developers.md b/docs/framework/install/guide-for-developers.md
@@ -34,7 +34,7 @@ Use the following table for quick links, or read further for details. To view th
 
 |.NET Framework version|Developer installation|Redistributable installation|Platform support|  
 |----------------------------|----------------------------|----------------------------------|----------------------|  
-|**4.7.1**|[NET Framework 4.7.1 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=852105)|[Download page for 4.7.1 web installer](http://go.microsoft.com/fwlink/?LinkId=852095)<br /><br /> [Download page for 4.7.1 offline installer](http://go.microsoft.com/fwlink/?LinkId=852107)|Included in: <br/>Windows 10 Fall Creators Update<br /><br /> You can install on:<br/> Windows 10 Creators Update <br /> Windows 10 Anniversary Update<br /> Windows 8.1 and earlier<br /> Windows Server 2012 R2 and earlier<br /> (for a full list, see [system requirements](~/docs/framework/get-started/system-requirements.md))||
+|**4.7.1**|[NET Framework 4.7.1 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=852105)|[Download page for 4.7.1 web installer](http://go.microsoft.com/fwlink/?LinkId=852095)<br /><br /> [Download page for 4.7.1 offline installer](http://go.microsoft.com/fwlink/?LinkId=852107)|Included in: <br/>Windows 10 Fall Creators Update<br/>Windows Server, version 1709<br /><br /> You can install on:<br/> Windows 10 Creators Update <br /> Windows 10 Anniversary Update<br /> Windows 8.1 and earlier<br /> Windows Server 2012 R2 and earlier<br /> (for a full list, see [system requirements](~/docs/framework/get-started/system-requirements.md))||
 |**4.7**|[NET Framework 4.7 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=825319)|[Download page for 4.7 web installer](http://go.microsoft.com/fwlink/?LinkId=825299)<br /><br /> [Download page for 4.7 offline installer](http://go.microsoft.com/fwlink/?LinkId=825303)|Included in: <br/>Windows 10 Creators Update<br /><br /> You can install on:<br /> Windows 10 Anniversary Update<br /> Windows 8.1 and earlier<br /> Windows Server 2012 R2 and earlier<br /> (for a full list, see [system requirements](~/docs/framework/get-started/system-requirements.md))||
 |**4.6.2**|[NET Framework 4.6.2 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=780617)|[Download page for 4.6.2 web installer](http://go.microsoft.com/fwlink/?LinkId=780597)<br /><br /> [Download page for 4.6.2 offline installer](http://go.microsoft.com/fwlink/?LinkId=780601)|Included in: <br /> Windows 10 Anniversary Edition<br /><br /> You can install on:<br /> Windows 10 <br /> Windows 8.1 and earlier<br /> Windows Server 2012 R2 and earlier<br /> (for a full list, see [system requirements](~/docs/framework/get-started/system-requirements.md))|
 |**4.6.1**|[NET Framework 4.6.1 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=690706)|[Download page for 4.6.1 web installer](http://go.microsoft.com/fwlink/?LinkId=671729)<br /><br /> [Download page for 4.6.1 offline installer](http://go.microsoft.com/fwlink/?LinkId=671744)|You can install on:<br /> Windows 10 <br /> Windows 8.1 and earlier<br /> Windows Server 2012 R2 and earlier<br /> (for a full list, see [system requirements](~/docs/framework/get-started/system-requirements.md))|

diff --git a/docs/framework/migration-guide/retargeting/index.md b/docs/framework/migration-guide/retargeting/index.md
@@ -13,7 +13,7 @@ ms.author: "ronpet"
 manager: "wpickett"
 ---
 
-# "Retargeting Changes in the .NET Framework"
+# Retargeting Changes in the .NET Framework
 
 [!include[introduction](../../../../includes/migration-guide/retargeting/introduction.md)]
 ## Usage

diff --git a/docs/framework/migration-guide/runtime/index.md b/docs/framework/migration-guide/runtime/index.md
@@ -13,7 +13,7 @@ ms.author: "ronpet"
 manager: "wpickett"
 ---
 
-# "Runtime Changes in the .NET Framework"
+# Runtime Changes in the .NET Framework
 
 [!include[introduction](../../../../includes/migration-guide/runtime/introduction.md)]
 ## Usage