Update live with current master

.github/PULL_REQUEST_TEMPLATE.md

@@ -2,4 +2,4 @@
 
 Describe your changes here.
 
-Fixes dotnet/docs#Issue_Number (if available)
+Fixes dotnet/docs#Issue_Number or dotnet/dotnet-api-docs#Issue_Number (if available)

snippets/cpp/VS_Snippets_Remoting/NCLUriExamples/CPP/uriexamples.cpp

@@ -67,6 +67,7 @@ namespace Example
          {
             Console::WriteLine( "The two addresses are not equal" );
          }
+         // Will output "The two addresses are equal"
          //</snippet8>
       }
 

snippets/csharp/VS_Snippets_Remoting/NCLUriExamples/CS/uriexamples.cs

@@ -65,6 +65,7 @@ private static void SampleEquals()
                 Console.WriteLine("The two addresses are equal");
             else
                 Console.WriteLine("The two addresses are not equal");
+            // Will output "The two addresses are equal"
         //</snippet8>
         }
 

snippets/csharp/language-reference/operators/LogicalOperators.cs

@@ -0,0 +1,165 @@
+using System;
+
+namespace operators
+{
+    public static class LogicalOperators
+    {
+        public static void Examples()
+        {
+            Console.WriteLine("==== ! operator");
+            Negation();
+
+            Console.WriteLine("==== &, |, ^ operators");
+            And();
+            Or();
+            Xor();
+
+            Console.WriteLine("==== && and || operators");
+            ConditionalAnd();
+            ConditionalOr();
+
+            Console.WriteLine("==== Compound assignment and precedence");
+            CompoundAssignment();
+            Precedence();
+        }
+
+        private static void Negation()
+        {
+            // <SnippetNegation>
+            bool passed = false;
+            Console.WriteLine(!passed);  // output: True
+            Console.WriteLine(!true);    // output: False
+            // </SnippetNegation>
+        }
+
+        private static void And()
+        {
+            // <SnippetAnd>
+            bool SecondOperand() 
+            {
+                Console.WriteLine("Second operand is evaluated.");
+                return true;
+            }
+
+            bool test = false & SecondOperand();
+            Console.WriteLine(test);
+            // Output:
+            // Second operand is evaluated.
+            // False
+            // </SnippetAnd>
+        }
+
+        private static void Or()
+        {
+            // <SnippetOr>
+            bool SecondOperand() 
+            {
+                Console.WriteLine("Second operand is evaluated.");
+                return false;
+            }
+
+            bool test = true | SecondOperand();
+            Console.WriteLine(test);
+            // Output:
+            // Second operand is evaluated.
+            // True
+            // </SnippetOr>
+        }
+
+        private static void Xor()
+        {
+            // <SnippetXor>
+            Console.WriteLine(true ^ true);    // output: False
+            Console.WriteLine(true ^ false);   // output: True
+            Console.WriteLine(false ^ true);   // output: True
+            Console.WriteLine(false ^ false);  // output: False
+            // </SnippetXor>
+        }
+
+        private static void ConditionalAnd()
+        {
+            // <SnippetConditionalAnd>
+            bool SecondOperand()
+            {
+                Console.WriteLine("Second operand is evaluated.");
+                return true;
+            }
+
+            bool a = false && SecondOperand();
+            Console.WriteLine(a);
+            // Output:
+            // False
+
+            bool b = true && SecondOperand();
+            Console.WriteLine(b);
+            // Output:
+            // Second operand is evaluated.
+            // True
+            // </SnippetConditionalAnd>
+        }
+
+        private static void ConditionalOr()
+        {
+            // <SnippetConditionalOr>
+            bool SecondOperand()
+            {
+                Console.WriteLine("Second operand is evaluated.");
+                return true;
+            }
+
+            bool a = true || SecondOperand();
+            Console.WriteLine(a);
+            // Output:
+            // True
+
+            bool b = false || SecondOperand();
+            Console.WriteLine(b);
+            // Output:
+            // Second operand is evaluated.
+            // True
+            // </SnippetConditionalOr>
+        }
+
+        private static void CompoundAssignment()
+        {
+            // <SnippetCompoundAssignment>
+            bool test = true;
+            test &= false;
+            Console.WriteLine(test);  // output: False
+
+            test |= true;
+            Console.WriteLine(test);  // output: True
+
+            test ^= false;
+            Console.WriteLine(test);  // output: True
+            // </SnippetCompoundAssignment>
+        }
+
+        private static void Precedence()
+        {
+            // <SnippetPrecedence>
+            Console.WriteLine(true | true & false);   // output: True
+            Console.WriteLine((true | true) & false); // output: False
+
+            bool Operand(string name, bool value)
+            {
+                Console.WriteLine($"Operand {name} is evaluated.");
+                return value;
+            }
+
+            var byDefaultPrecedence = Operand("A", true) || Operand("B", true) && Operand("C", false);
+            Console.WriteLine(byDefaultPrecedence);
+            // Output:
+            // Operand A is evaluated.
+            // True
+
+            var changedOrder = (Operand("A", true) || Operand("B", true)) && Operand("C", false);
+            Console.WriteLine(changedOrder);
+            // Output:
+            // Operand A is evaluated.
+            // Operand C is evaluated.
+            // False
+            // </SnippetPrecedence>
+        }
+    }
+}

snippets/csharp/language-reference/operators/Program.cs

@@ -10,6 +10,14 @@ static void Main(string[] args)
             ArithmeticOperators.Examples();
             Console.WriteLine();
 
+            Console.WriteLine("============== == and != operator examples =====");
+            EqualityAndNonEqualityExamples.Examples();
+            Console.WriteLine();
+
+            Console.WriteLine("======== Logical operators examples ============");
+            LogicalOperators.Examples();
+            Console.WriteLine();
+
             Console.WriteLine("============== + operator examples =============");
             AdditionExamples.Examples();
             Console.WriteLine();
@@ -30,14 +38,6 @@ static void Main(string[] args)
             BitwiseComplementExamples.Examples();
             Console.WriteLine();
 
-            Console.WriteLine("============== && and || operator examples =====");
-            ConditionalLogicalOperatorsExamples.Examples();
-            Console.WriteLine();
-
-            Console.WriteLine("============== == and != operator examples =====");
-            EqualityAndNonEqualityExamples.Examples();
-            Console.WriteLine();
-
             Console.WriteLine("======= >, <, >=, and <= operator examples =====");
             GreaterAndLessOperatorsExamples.Examples();
             Console.WriteLine();
@@ -58,10 +58,6 @@ static void Main(string[] args)
             ShiftOperatorsExamples.Examples();
             Console.WriteLine();
 
-            Console.WriteLine("============== ! operator examples =============");
-            LogicalNegationExamples.Examples();
-            Console.WriteLine();
-
             Console.WriteLine("============== . operator examples =============");
             MemberAccessExamples.Examples();
             Console.WriteLine();

snippets/visualbasic/VS_Snippets_Remoting/NCLUriExamples/VB/uriexamples.vb

@@ -62,6 +62,7 @@ Public Class Test
         Else
             Console.WriteLine("The two addresses are not equal")
         End If
+        ' Will output "The two addresses are equal"
      '</snippet8>
     End Sub 'SampleEquals