dotnet · BillWagner · Dec 20, 2018 · Dec 19, 2018 · Dec 19, 2018 · Dec 19, 2018
diff --git a/docs/core/deploying/runtime-patch-selection.md b/docs/core/deploying/runtime-patch-selection.md
@@ -1,8 +1,7 @@
 ---
 title: Runtime roll forward for .NET Core self-contained app deployments.
 description: Learn about dotnet publish changes for self-contained deployments.
-author: jralexander
-ms.author: kdollard
+author: KathleenDollard
 ms.date: 05/31/2018
 ms.custom: seodec18
 ---

diff --git a/docs/core/docker/building-net-docker-images.md b/docs/core/docker/building-net-docker-images.md
@@ -1,8 +1,6 @@
 ---
 title: Docker images overview
 description: Learn how to use the published .NET Core Docker images from the Docker Registry. You will also learn how to pull images and build your own images.
-author: jralexander
-ms.author: johalex
 ms.date: 11/06/2017
 ms.topic: tutorial
 ms.custom: "mvc, seodec18"

diff --git a/docs/core/docker/intro-net-docker.md b/docs/core/docker/intro-net-docker.md
@@ -1,8 +1,6 @@
 ---
 title: Introduction to Docker
 description: This article provides an introduction and overview to Docker in the context of a .NET Core application.
-author: jralexander
-ms.author: johalex
 ms.date: 11/06/2017
 ms.custom: "mvc, seodec18"
 ---

diff --git a/docs/core/linux-prerequisites.md b/docs/core/linux-prerequisites.md
@@ -3,7 +3,7 @@ title: Prerequisites for .NET Core on Linux
 description: Supported Linux versions and .NET Core dependencies to develop, deploy, and run .NET Core applications on Linux machines.
 author: thraka
 ms.author: adegeo
-ms.date: 12/03/2018
+ms.date: 12/14/2018
 ---
 # Prerequisites for .NET Core on Linux
 
@@ -55,6 +55,34 @@ For download links and more information, see [.NET Core 1.1 downloads](https://w
 
 See [.NET Core 1.x Supported OS Versions](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0-supported-os.md) for the complete list of .NET Core 1.x supported operating systems, out of support OS versions, and lifecycle policy links.
 
+# [.NET Core 3.0 Preview 1](#tab/netcore30)
+
+.NET Core 3.0 Preview 1 treats Linux as a single operating system. There is a single Linux build (per chip architecture) for supported Linux distributions. 
+
+For download links and more information, see [.NET Core 3.0 downloads](https://dotnet.microsoft.com/download/dotnet-core/3.0).
+
+.NET Core 3.0 Preview 1 is supported on the following Linux distributions/versions. 
+
+OS                            | Version               | Architectures  
+------------------------------|-----------------------|----------------
+Red Hat Enterprise Linux      | 6                     | x64
+Red Hat Enterprise Linux<br>CentOS<br>Oracle Linux  | 7                     | x64
+Fedora                        | 28                    | x64
+Debian                        | 9                     | x64, ARM32\*, ARM64\*
+Ubuntu                        | 16.04+, 18.04+        | x64, ARM32\*, ARM64\*
+Linux Mint                    | 18                    | x64
+openSUSE                      | 42.3+                 | x64
+SUSE Enterprise Linux (SLES)  | 12 SP2+               | x64
+Alpine Linux                  | 3.8+                  | x64, ARM64
+
+\* ARM32 and ARM64 support starts with Debian 9 and Ubuntu 16.04. Earlier versions of those distros are not supported on ARM chips.
+
+See [.NET Core 3.0 Supported OS Versions](https://github.com/dotnet/core/blob/master/release-notes/3.0/3.0-supported-os.md) for the complete list of .NET Core 3.0 supported operating systems, distributions and versions, out of support OS versions, and lifecycle policy links.
+
+For more information about how to install .NET Core 3.0 on ARM64, see [Installing .NET Core 3.0 on Linux ARM64](https://gist.github.com/richlander/467813274cea8abc624553ee72b28213).
+
+
+
 ---
 
 ## Linux distribution dependencies

diff --git a/docs/core/macos-prerequisites.md b/docs/core/macos-prerequisites.md
@@ -3,7 +3,7 @@ title: Prerequisites for .NET Core on Mac
 description: Supported macOS versions and .NET Core dependencies to develop, deploy, and run .NET Core applications on macOS machines.
 author: guardrex
 ms.author: adegeo
-ms.date: 12/03/2018
+ms.date: 12/14/2018
 ---
 # Prerequisites for .NET Core on macOS
 
@@ -33,6 +33,16 @@ See [.NET Core 1.1 Supported OS Versions](https://github.com/dotnet/core/blob/ma
 
 For download links and more information, see [.NET Core 1.1 downloads](https://www.microsoft.com/net/download/dotnet-core/1.1) or [.NET Core 1.0 downloads](https://www.microsoft.com/net/download/dotnet-core/1.0).
 
+# [.NET Core 3.0 Preview 1](#tab/netcore30)
+
+.NET Core 3.0 Preview 1 is supported on the following versions of macOS:
+
+* macOS 10.12 "Sierra" and later versions
+
+See [.NET Core 3.0 Supported OS Versions](https://github.com/dotnet/core/blob/master/release-notes/3.0/3.0-supported-os.md) for the complete list of .NET Core 3.0 supported operating systems, distributions and versions, out of support OS versions, and lifecycle policy links.
+
+For download links and more information, see [.NET Core 3.0 downloads](https://www.microsoft.com/net/download/dotnet-core/3.0).
+
 ---
 
 ## .NET Core dependencies
@@ -43,8 +53,6 @@ Download and install the .NET Core SDK from [.NET Downloads](https://www.microso
 
 # [.NET Core 1.x](#tab/netcore1x)
 
-**.NET Core 1.x**
-
 .NET Core 1.x requires OpenSSL when running on macOS. An easy way to obtain OpenSSL is by using the [Homebrew ("brew")](https://brew.sh/) package manager for macOS. After installing *brew*, install OpenSSL by executing the following commands at a Terminal (command) prompt:
 
 ```console
@@ -57,6 +65,10 @@ ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/
 
 Download and install the .NET Core SDK from [.NET Downloads](https://www.microsoft.com/net/download/core). If you have problems with the installation on macOS, consult the [1.0.0 Known Issues](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0.0-known-issues.md) and [1.0.1 Known Issues](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0.1-known-issues.md) topics.
 
+# [.NET Core 3.0 Preview 1](#tab/netcore30)
+
+Download and install the .NET Core SDK from [.NET Downloads](https://www.microsoft.com/net/download/core). If you have problems with the installation on macOS, consult the [Release notes](https://github.com/dotnet/core/blob/master/release-notes/3.0/3.0-supported-os.md) topic for the version you have installed.
+
 ---
 
 ## Increase the maximum open file limit (.NET Core versions before .NET Core SDK 2.0.2) 

diff --git a/docs/core/windows-prerequisites.md b/docs/core/windows-prerequisites.md
@@ -1,8 +1,9 @@
 ---
 title: Prerequisites for .NET Core on Windows
 description: Learn what dependencies you need on your Windows machine to develop and run .NET Core applications.
-ms.date: 12/10/2018
+ms.date: 12/14/2018
 ---
+
 # Prerequisites for .NET Core on Windows
 
 This article shows the supported OS versions in order to run .NET Core applications on Windows. The supported OS versions and dependencies that follow apply to the three ways of developing .NET Core apps on Windows:
@@ -29,11 +30,12 @@ Also, if you're developing on Windows using Visual Studio 2017, the [Prerequisit
 
 The following articles have a complete list of .NET Core supported operating systems per version:
 
+* [.NET Core 3.0 (Preview)](https://github.com/dotnet/core/blob/master/release-notes/3.0/3.0-supported-os.md)
 * [.NET Core 2.2](https://github.com/dotnet/core/blob/master/release-notes/2.2/2.2-supported-os.md)
 * [.NET Core 2.1](https://github.com/dotnet/core/blob/master/release-notes/2.1/2.1-supported-os.md)
 * [.NET Core 1.0](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0-supported-os.md)
 
-For download links and more information, see [.NET downloads](https://www.microsoft.com/net/download) to download the latest version or [.NET downloads archive](https://dotnet.microsoft.com/download/archives#dotnet-core) for older versions.
+For download links and more information, see [.NET downloads](https://dotnet.microsoft.com/download) to download the latest version or [.NET downloads archive](https://dotnet.microsoft.com/download/archives#dotnet-core) for older versions.
 
 ## .NET Core dependencies
 
@@ -55,8 +57,12 @@ For download links and more information, see [.NET downloads](https://www.micros
 >
 > In addition to KB2999226, make sure you also have [KB2533623](https://support.microsoft.com/en-us/help/2533623/microsoft-security-advisory-insecure-library-loading-could-allow-remot) installed. If you don't have this update installed, you'll see an error similar to the following when you launch a .NET Core application: `The library hostfxr.dll was found, but loading it from C:\<path_to_app>\hostfxr.dll failed`.
 
-## Prerequisites with Visual Studio 2017
+## Prerequisites for .NET Core 3.0 Preview 1
 
+.NET Core 3.0 Preview 1 has the same prerequisites as other versions of .NET Core. However, if you want to use Visual Studio to create .NET Core 3.0 projects, you must use the [Visual Studio 2019 Preview](https://visualstudio.microsoft.com/vs/preview/). Visual Studio 2019 Preview can be installed side-by-side with other versions of Visual Studio without conflict.
+
+## Prerequisites with Visual Studio 2017
+
 You can use any editor to develop .NET Core applications using the .NET Core SDK. Visual Studio 2017 provides an integrated development environment for .NET Core apps on Windows.
 
 You can read more about the changes in Visual Studio 2017 in the [release notes](/visualstudio/releasenotes/vs2017-relnotes).

diff --git a/docs/csharp/language-reference/operators/codesnippet/CSharp/greater-than-equal-operator_1.cs b/docs/csharp/language-reference/operators/codesnippet/CSharp/greater-than-equal-operator_1.cs
diff --git a/docs/csharp/language-reference/operators/codesnippet/CSharp/greater-than-operator_1.cs b/docs/csharp/language-reference/operators/codesnippet/CSharp/greater-than-operator_1.cs
diff --git a/docs/csharp/language-reference/operators/codesnippet/CSharp/less-than-equal-operator_1.cs b/docs/csharp/language-reference/operators/codesnippet/CSharp/less-than-equal-operator_1.cs
diff --git a/docs/csharp/language-reference/operators/codesnippet/CSharp/less-than-operator_1.cs b/docs/csharp/language-reference/operators/codesnippet/CSharp/less-than-operator_1.cs
diff --git a/docs/csharp/language-reference/operators/equality-comparison-operator.md b/docs/csharp/language-reference/operators/equality-comparison-operator.md
@@ -19,6 +19,9 @@ Operands of the [built-in value types](../keywords/value-types-table.md) are equ
 
 [!code-csharp-interactive[value types equality](~/samples/snippets/csharp/language-reference/operators/EqualityAndNonEqualityExamples.cs#ValueTypesEquality)]
 
+> [!NOTE]
+> For relational operators `==`, `>`, `<`, `>=`, and `<=`, if any of the operands is not a number (<xref:System.Double.NaN?displayProperty=nameWithType> or <xref:System.Single.NaN?displayProperty=nameWithType>) the result of operation is `false`. That means that the `NaN` value is neither greater than, less than, nor equal to any other `double` (or `float`) value. For more information and examples, see the <xref:System.Double.NaN?displayProperty=nameWithType> or <xref:System.Single.NaN?displayProperty=nameWithType> reference article.
+
 Two operands of the same [enum](../keywords/enum.md) type are equal if the corresponding values of the underlying integral type are equal.
 
 By default, the `==` operator is not defined for a user-defined [struct](../keywords/struct.md) type. A user-defined type can [overload](#operator-overloadability) the `==` operator.

diff --git a/docs/csharp/language-reference/operators/greater-than-equal-operator.md b/docs/csharp/language-reference/operators/greater-than-equal-operator.md
@@ -1,8 +1,7 @@
 ---
 title: "&gt;= Operator - C# Reference"
 ms.custom: seodec18
-
-ms.date: 07/20/2015
+ms.date: 12/18/2018
 f1_keywords: 
   - ">=_CSharpKeyword"
 helpviewer_keywords: 
@@ -11,16 +10,29 @@ helpviewer_keywords:
 ms.assetid: 0db4dcaf-56a3-4884-a7ad-35f64978a58d
 ---
 # &gt;= Operator (C# Reference)
-All numeric and enumeration types define a "greater than or equal" relational operator, `>=` that returns `true` if the first operand is greater than or equal to the second, `false` otherwise.  
-
-## Remarks  
- User-defined types can overload the `>=` operator. For more information, see [operator](../../../csharp/language-reference/keywords/operator.md). If `>=` is overloaded, [<=](../../../csharp/language-reference/operators/less-than-equal-operator.md) must also be overloaded. Operations on integral types are generally allowed on enumeration.  
-
-## Example  
- [!code-csharp[csRefOperators#39](../../../csharp/language-reference/operators/codesnippet/CSharp/greater-than-equal-operator_1.cs)]  
-
-## See Also
-
-- [C# Reference](../../../csharp/language-reference/index.md)  
-- [C# Programming Guide](../../../csharp/programming-guide/index.md)  
-- [C# Operators](../../../csharp/language-reference/operators/index.md)
+
+The "greater than or equal" relational operator `>=` returns `true` if its first operand is greater than or equal to its second operand, `false` otherwise. All numeric and  enumeration types support the `>=` operator. For operands of the same [enum](../keywords/enum.md) type, the corresponding values of the underlying integral type are compared.
+
+> [!NOTE]
+> For relational operators `==`, `>`, `<`, `>=`, and `<=`, if any of the operands is not a number (<xref:System.Double.NaN?displayProperty=nameWithType> or <xref:System.Single.NaN?displayProperty=nameWithType>) the result of operation is `false`. That means that the `NaN` value is neither greater than, less than, nor equal to any other `double` (or `float`) value. For more information and examples, see the <xref:System.Double.NaN?displayProperty=nameWithType> or <xref:System.Single.NaN?displayProperty=nameWithType> reference article.
+
+The following example demonstrates the usage of the `>=` operator:
+
+[!code-csharp-interactive[greater than or equal example](~/samples/snippets/csharp/language-reference/operators/GreaterAndLessOperatorsExamples.cs#GreaterOrEqual)]
+
+## Operator overloadability
+
+User-defined types can [overload](../keywords/operator.md) the `>=` operator. If a type overloads the "greater than or equal" operator `>=`, it must also overload the ["less than or equal" operator](less-than-equal-operator.md) `<=`.
+
+## C# language specification
+
+For more information, see the [Relational and type-testing operators](~/_csharplang/spec/expressions.md#relational-and-type-testing-operators) section of the [C# language specification](../language-specification/index.md).
+
+## See also
+
+- [C# Reference](../index.md)
+- [C# Programming Guide](../../programming-guide/index.md)
+- [C# Operators](index.md)
+- [> Operator](greater-than-operator.md)
+- [== Operator](equality-comparison-operator.md)
+- <xref:System.IComparable%601?displayProperty=nameWithType>
diff --git a/docs/csharp/language-reference/operators/greater-than-operator.md b/docs/csharp/language-reference/operators/greater-than-operator.md
@@ -1,8 +1,7 @@
 ---
 title: "&gt; Operator - C# Reference"
 ms.custom: seodec18
-
-ms.date: 07/20/2015
+ms.date: 12/18/2018
 f1_keywords: 
   - ">_CSharpKeyword"
 helpviewer_keywords: 
@@ -11,17 +10,28 @@ helpviewer_keywords:
 ms.assetid: 26d3cb69-9c0b-4cc5-858b-5be1abd6659d
 ---
 # &gt; Operator (C# Reference)
-All numeric and enumeration types define a "greater than" relational operator (`>`) that returns `true` if the first operand is greater than the second, `false` otherwise.  
-
-## Remarks  
- User-defined types can overload the `>` operator (see [operator](../../../csharp/language-reference/keywords/operator.md)). If `>` is overloaded, [<](../../../csharp/language-reference/operators/less-than-operator.md) must also be overloaded.
-
-## Example  
- [!code-csharp[csRefOperators#29](../../../csharp/language-reference/operators/codesnippet/CSharp/greater-than-operator_1.cs)]  
-
-## See Also
-
-- [C# Reference](../../../csharp/language-reference/index.md)  
-- [C# Programming Guide](../../../csharp/programming-guide/index.md)  
-- [C# Operators](../../../csharp/language-reference/operators/index.md)  
-- [explicit](../../../csharp/language-reference/keywords/explicit.md)
+
+The "greater than" relational operator `>` returns `true` if its first operand is greater than its second operand, `false` otherwise. All numeric and enumeration types support the `>` operator. For operands of the same [enum](../keywords/enum.md) type, the corresponding values of the underlying integral type are compared.
+
+> [!NOTE]
+> For relational operators `==`, `>`, `<`, `>=`, and `<=`, if any of the operands is not a number (<xref:System.Double.NaN?displayProperty=nameWithType> or <xref:System.Single.NaN?displayProperty=nameWithType>) the result of operation is `false`. That means that the `NaN` value is neither greater than, less than, nor equal to any other `double` (or `float`) value. For more information and examples, see the <xref:System.Double.NaN?displayProperty=nameWithType> or <xref:System.Single.NaN?displayProperty=nameWithType> reference article.
+
+The following example demonstrates the usage of the `>` operator:
+
+[!code-csharp-interactive[greater than example](~/samples/snippets/csharp/language-reference/operators/GreaterAndLessOperatorsExamples.cs#Greater)]
+
+## Operator overloadability
+
+User-defined types can [overload](../keywords/operator.md) the `>` operator. If a type overloads the "greater than" operator `>`, it must also overload the ["less than" operator](less-than-operator.md) `<`.
+
+## C# language specification
+
+For more information, see the [Relational and type-testing operators](~/_csharplang/spec/expressions.md#relational-and-type-testing-operators) section of the [C# language specification](../language-specification/index.md).
+
+## See also
+
+- [C# Reference](../index.md)
+- [C# Programming Guide](../../programming-guide/index.md)
+- [C# Operators](index.md)
+- [>= Operator](greater-than-equal-operator.md)
+- <xref:System.IComparable%601?displayProperty=nameWithType>