Merge branch 'master' into dart-formatting

1 files changed, 36 insertions, 34 deletions

diff --git a/csharp.html.markdown b/csharp.html.markdown
index df6544d3..0643f033 100644
--- a/csharp.html.markdown
+++ b/csharp.html.markdown
@@ -14,20 +14,22 @@ filename: LearnCSharp.cs
 
 C# is an elegant and type-safe object-oriented language that enables developers to build a variety of secure and robust applications that run on the .NET Framework.
 
-[Read more here.](http://msdn.microsoft.com/en-us/library/vstudio/z1zx9t92.aspx)
+[Read more here.](https://docs.microsoft.com/dotnet/csharp/getting-started/introduction-to-the-csharp-language-and-the-net-framework)
 
 ```c#
 // Single-line comments start with //
+
 /*
 Multi-line comments look like this
 */
+
 /// <summary>
 /// This is an XML documentation comment which can be used to generate external
 /// documentation or provide context help within an IDE
 /// </summary>
 /// <param name="firstParam">This is some parameter documentation for firstParam</param>
 /// <returns>Information on the returned value of a function</returns>
-//public void MethodOrClassOrOtherWithParsableHelp(string firstParam) {}
+public void MethodOrClassOrOtherWithParsableHelp(string firstParam) {}
 
 // Specify the namespaces this source code will be using
 // The namespaces below are all part of the standard .NET Framework Class Library
@@ -254,7 +256,7 @@ on a new line! ""Wow!"", the masses cried";
             int fooWhile = 0;
             while (fooWhile < 100)
             {
-                //Iterated 100 times, fooWhile 0->99
+                // Iterated 100 times, fooWhile 0->99
                 fooWhile++;
             }
 
@@ -273,10 +275,10 @@ on a new line! ""Wow!"", the masses cried";
 
             } while (fooDoWhile < 100);
 
-            //for loop structure => for(<start_statement>; <conditional>; <step>)
+            // for loop structure => for(<start_statement>; <conditional>; <step>)
             for (int fooFor = 0; fooFor < 10; fooFor++)
             {
-                //Iterated 10 times, fooFor 0->9
+                // Iterated 10 times, fooFor 0->9
             }
 
             // For Each Loop
@@ -287,7 +289,7 @@ on a new line! ""Wow!"", the masses cried";
             // (The ToCharArray() could be removed, because a string also implements IEnumerable)
             foreach (char character in "Hello World".ToCharArray())
             {
-                //Iterated over all the characters in the string
+                // Iterated over all the characters in the string
             }
 
             // Switch Case
@@ -329,7 +331,7 @@ on a new line! ""Wow!"", the masses cried";
 
             // Convert String To Integer
             // this will throw a FormatException on failure
-            int.Parse("123");//returns an integer version of "123"
+            int.Parse("123"); // returns an integer version of "123"
 
             // try parse will default to type default on failure
             // in this case: 0
@@ -373,7 +375,7 @@ on a new line! ""Wow!"", the masses cried";
             Console.Read();
         } // End main method
 
-        // CONSOLE ENTRY A console application must have a main method as an entry point
+        // CONSOLE ENTRY - A console application must have a main method as an entry point
         public static void Main(string[] args)
         {
             OtherInterestingFeatures();
@@ -404,7 +406,7 @@ on a new line! ""Wow!"", the masses cried";
             ref int maxCount, // Pass by reference
             out int count)
         {
-            //the argument passed in as 'count' will hold the value of 15 outside of this function
+            // the argument passed in as 'count' will hold the value of 15 outside of this function
             count = 15; // out param must be assigned before control leaves the method
         }
 
@@ -552,7 +554,7 @@ on a new line! ""Wow!"", the masses cried";
             }
 
             // PARALLEL FRAMEWORK
-            // http://blogs.msdn.com/b/csharpfaq/archive/2010/06/01/parallel-programming-in-net-framework-4-getting-started.aspx
+            // https://devblogs.microsoft.com/csharpfaq/parallel-programming-in-net-framework-4-getting-started/
 
             var words = new List<string> {"dog", "cat", "horse", "pony"};
 
@@ -564,11 +566,11 @@ on a new line! ""Wow!"", the masses cried";
                 }
             );
 
-            //Running this will produce different outputs
-            //since each thread finishes at different times.
-            //Some example outputs are:
-            //cat dog horse pony
-            //dog horse pony cat
+            // Running this will produce different outputs
+            // since each thread finishes at different times.
+            // Some example outputs are:
+            // cat dog horse pony
+            // dog horse pony cat
 
             // DYNAMIC OBJECTS (great for working with other languages)
             dynamic student = new ExpandoObject();
@@ -725,10 +727,10 @@ on a new line! ""Wow!"", the masses cried";
         int _speed; // Everything is private by default: Only accessible from within this class.
                     // can also use keyword private
         public string Name { get; set; }
-        
+
         // Properties also have a special syntax for when you want a readonly property
         // that simply returns the result of an expression
-        public string LongName => Name + " " + _speed + " speed"; 
+        public string LongName => Name + " " + _speed + " speed";
 
         // Enum is a value type that consists of a set of named constants
         // It is really just mapping a name to a value (an int, unless specified otherwise).
@@ -865,7 +867,7 @@ on a new line! ""Wow!"", the masses cried";
             }
         }
 
-        //Method to display the attribute values of this Object.
+        // Method to display the attribute values of this Object.
         public virtual string Info()
         {
             return "Gear: " + Gear +
@@ -960,7 +962,7 @@ on a new line! ""Wow!"", the masses cried";
     /// <summary>
     /// Used to connect to DB for LinqToSql example.
     /// EntityFramework Code First is awesome (similar to Ruby's ActiveRecord, but bidirectional)
-    /// http://msdn.microsoft.com/en-us/data/jj193542.aspx
+    /// https://docs.microsoft.com/ef/ef6/modeling/code-first/workflows/new-database
     /// </summary>
     public class BikeRepository : DbContext
     {
@@ -1069,7 +1071,7 @@ on a new line! ""Wow!"", the masses cried";
     {
         private static bool LogException(Exception ex)
         {
-            /* log exception somewhere */
+            // log exception somewhere
             return false;
         }
 
@@ -1089,7 +1091,7 @@ on a new line! ""Wow!"", the masses cried";
                 // Spell failed
                 return false;
             }
-            // Other exceptions, or MagicServiceException where Code is not 42 
+            // Other exceptions, or MagicServiceException where Code is not 42
             catch(Exception ex) when (LogException(ex))
             {
                 // Execution never reaches this block
@@ -1117,12 +1119,12 @@ on a new line! ""Wow!"", the masses cried";
         [Obsolete("Use NewMethod instead", false)]
         public static void ObsoleteMethod()
         {
-            /* obsolete code */
+            // obsolete code
         }
 
         public static void NewMethod()
         {
-            /* new code */
+            // new code
         }
 
         public static void Main()
@@ -1154,9 +1156,9 @@ namespace Learning.More.CSharp
     }
 }
 
-//New C# 7 Feature
-//Install Microsoft.Net.Compilers Latest from Nuget
-//Install System.ValueTuple Latest from Nuget
+// New C# 7 Feature
+// Install Microsoft.Net.Compilers Latest from Nuget
+// Install System.ValueTuple Latest from Nuget
 using System;
 namespace Csharp7
 {
@@ -1213,7 +1215,7 @@ namespace Csharp7
             Console.WriteLine(tt.GetLastName());
         }
     }
-    
+
     // PATTERN MATCHING
     class PatternMatchingTest
     {
@@ -1310,13 +1312,13 @@ namespace Csharp7
 
 ## Further Reading
 
+ * [C# language reference](https://docs.microsoft.com/dotnet/csharp/language-reference/)
+ * [Learn .NET](https://dotnet.microsoft.com/learn)
+ * [C# Coding Conventions](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/inside-a-program/coding-conventions)
  * [DotNetPerls](http://www.dotnetperls.com)
  * [C# in Depth](http://manning.com/skeet2)
- * [Programming C#](http://shop.oreilly.com/product/0636920024064.do)
- * [LINQ](http://shop.oreilly.com/product/9780596519254.do)
- * [MSDN Library](http://msdn.microsoft.com/en-us/library/618ayhy6.aspx)
- * [ASP.NET MVC Tutorials](http://www.asp.net/mvc/tutorials)
- * [ASP.NET Web Matrix Tutorials](http://www.asp.net/web-pages/tutorials)
- * [ASP.NET Web Forms Tutorials](http://www.asp.net/web-forms/tutorials)
+ * [Programming C# 5.0](http://shop.oreilly.com/product/0636920024064.do)
+ * [LINQ Pocket Reference](http://shop.oreilly.com/product/9780596519254.do)
  * [Windows Forms Programming in C#](http://www.amazon.com/Windows-Forms-Programming-Chris-Sells/dp/0321116208)
- * [C# Coding Conventions](http://msdn.microsoft.com/en-us/library/vstudio/ff926074.aspx)
+ * [freeCodeCamp - C# Tutorial for Beginners](https://www.youtube.com/watch?v=GhQdlIFylQ8)
+ 
\ No newline at end of file