Format documentation files

ErikSchierboom · ErikSchierboom · commit 93a53b444ea3 · 2021-02-16T10:23:56.000+01:00
diff --git a/docs/LEARNING.md b/docs/LEARNING.md
@@ -14,6 +14,7 @@
 * [PluralSight](https://www.pluralsight.com/) has several [great](https://www.pluralsight.com/courses/csharp-6-from-scratch) [introduction](https://www.pluralsight.com/courses/c-sharp-fundamentals-with-visual-studio-2015) [courses](http://www.pluralsight.com/courses/csharp-best-practices-improving-basics). The downside: PluralSight is a paid service, but you can request a [free trial](https://www.pluralsight.com/pricing).
 
 ## Books
+
 * [C# 6.0 in a Nutshell](https://www.amazon.com/C-6-0-Nutshell-Definitive-Reference/dp/1491927062/)
 * [C# 5.0 Unleashed](https://www.amazon.com/C-5-0-Unleashed-Bart-Smet/dp/0672336901/)
 * [C# in Depth](https://www.amazon.com/dp/161729134X/)
diff --git a/exercises/practice/accumulate/.docs/instructions.append.md b/exercises/practice/accumulate/.docs/instructions.append.md
@@ -6,5 +6,6 @@ To be more specific, you are not allowed to use any of the built-in [LINQ method
 
 Since `accumulate` returns an `IEnumerable`, it's execution is deferred until `ToList()` it is called on it, which is tested with the `Accumulate_is_lazy` method
 
-## Hints		
-This exercise requires you to write an extension method. For more information, see [this page](https://msdn.microsoft.com/en-us//library/bb383977.aspx).
+## Hints
+
+This exercise requires you to write an extension method. For more information, see [this page](https://msdn.microsoft.com/en-us//library/bb383977.aspx).
diff --git a/exercises/practice/allergies/.docs/instructions.append.md b/exercises/practice/allergies/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
-This exercise requires you to use bitwise operations. For more information, see [this page](https://msdn.microsoft.com/en-us/library/6a71f45d.aspx). 
+
+This exercise requires you to use bitwise operations. For more information, see [this page](https://msdn.microsoft.com/en-us/library/6a71f45d.aspx).
diff --git a/exercises/practice/alphametics/.docs/instructions.append.md b/exercises/practice/alphametics/.docs/instructions.append.md
@@ -1,5 +1,6 @@
 # Hints
+
 - To parse the text, you could try to use the [Sprache](https://github.com/sprache/Sprache/blob/develop/README.md) library. You can also find a good tutorial [here](https://www.thomaslevesque.com/2017/02/23/easy-text-parsing-in-c-with-sprache/).
 - You can solve this exercise with a brute force algorithm, but this will possibly have a poor runtime performance.
-Try to find a more sophisticated solution. 
+  Try to find a more sophisticated solution.
 - Hint: You could try the column-wise addition algorithm that is usually taught in school.
diff --git a/exercises/practice/bank-account/.docs/instructions.append.md b/exercises/practice/bank-account/.docs/instructions.append.md
@@ -1,3 +1,4 @@
 # Hints
-This exercise requires you to handle data related to currency and money. A normal approuch is to use the [Decimal](https://msdn.microsoft.com/en-US/library/system.decimal.aspx) struct to store currency values. 
-Note though that you then only store the numeric value of a currency. 
+
+This exercise requires you to handle data related to currency and money. A normal approuch is to use the [Decimal](https://msdn.microsoft.com/en-US/library/system.decimal.aspx) struct to store currency values.
+Note though that you then only store the numeric value of a currency.
diff --git a/exercises/practice/beer-song/.docs/instructions.append.md b/exercises/practice/beer-song/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
-- Try to capture the structure of the song in your code, where you build up the song by composing its parts.
+
+- Try to capture the structure of the song in your code, where you build up the song by composing its parts.
diff --git a/exercises/practice/clock/.docs/instructions.append.md b/exercises/practice/clock/.docs/instructions.append.md
@@ -1,3 +1,4 @@
 # Hints
+
 This exercise requires you to implement a type-specific method for determining equality of instances.
 For more information, see [this page](https://docs.microsoft.com/en-us/dotnet/api/System.IEquatable-1?view=netcore-2.1).
diff --git a/exercises/practice/diamond/.docs/instructions.append.md b/exercises/practice/diamond/.docs/instructions.append.md
@@ -1,5 +1,6 @@
 # Hints
-The tests in this exercise are different from your usual tests. Normally, a test checks if for a given input, the output matches the expected value. This is called *value-based testing*. However, this exercise uses *property-based testing*, where the tests check if for a range of inputs, the output has a specific property. The two key differences that differentiate property-based testing from value-based testing are:
+
+The tests in this exercise are different from your usual tests. Normally, a test checks if for a given input, the output matches the expected value. This is called _value-based testing_. However, this exercise uses _property-based testing_, where the tests check if for a range of inputs, the output has a specific property. The two key differences that differentiate property-based testing from value-based testing are:
 
 1. A property-based test works not with a single input value, but with many.
 1. A property-based test verifies properties, not concrete values.
@@ -8,4 +9,4 @@ For this exercise, the tests all verify a property of the diamond shape your cod
 
 In order to facilitate propery-based testing, the tests in this exercise leverage the [FsCheck](https://www.nuget.org/packages/FsCheck) and [FsCheck.Xunit](https://packages.nuget.org/packages/FsCheck.Xunit/2.2.0) packages. To learn more about FsCheck, the documentation on the framework can be found [here](https://fscheck.github.io/FsCheck/).
 
-If you would like more information on property-based testing, see [this article](http://www.erikschierboom.com/2016/02/22/property-based-testing/).
+If you would like more information on property-based testing, see [this article](http://www.erikschierboom.com/2016/02/22/property-based-testing/).
diff --git a/exercises/practice/difference-of-squares/.docs/instructions.append.md b/exercises/practice/difference-of-squares/.docs/instructions.append.md
@@ -1,4 +1,5 @@
 # Hints
+
 This exercise requires you to process a collection of data. You can simplify your code by using LINQ (Language Integrated Query).
 For more information, see [this page]
-(https://docs.microsoft.com/en-us/dotnet/articles/standard/using-linq).
+(https://docs.microsoft.com/en-us/dotnet/articles/standard/using-linq).
diff --git a/exercises/practice/diffie-hellman/.docs/instructions.append.md b/exercises/practice/diffie-hellman/.docs/instructions.append.md
@@ -1,3 +1,4 @@
 # Hints
+
 This exercise requires you to perform calculations on large numbers. To correctly represent large numbers, the
-[BigInteger](https://msdn.microsoft.com/en-us/library/system.numerics.biginteger(v=vs.110).aspx) struct is used.
+[BigInteger](<https://msdn.microsoft.com/en-us/library/system.numerics.biginteger(v=vs.110).aspx>) struct is used.
diff --git a/exercises/practice/dot-dsl/.docs/instructions.append.md b/exercises/practice/dot-dsl/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
-This exercise requires you to implement classes with a custom equality check. For more information, see [this page](https://msdn.microsoft.com/en-us/library/bsc2ak47(v=vs.110).aspx).
+
+This exercise requires you to implement classes with a custom equality check. For more information, see [this page](<https://msdn.microsoft.com/en-us/library/bsc2ak47(v=vs.110).aspx>).
diff --git a/exercises/practice/food-chain/.docs/instructions.append.md b/exercises/practice/food-chain/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
+
 - Try to capture the structure of the song in your code, where you build up the song by composing its parts.
diff --git a/exercises/practice/forth/.docs/instructions.append.md b/exercises/practice/forth/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
+
 - To parse the text, you could try to use the [Sprache](https://github.com/sprache/Sprache/blob/develop/README.md) library. You can also find a good tutorial [here](https://www.thomaslevesque.com/2017/02/23/easy-text-parsing-in-c-with-sprache/).
diff --git a/exercises/practice/hangman/.docs/instructions.append.md b/exercises/practice/hangman/.docs/instructions.append.md
@@ -1,5 +1,6 @@
 # Hints
-This exercise requires you to work with Reactive extension. For more information, see 
+
+This exercise requires you to work with Reactive extension. For more information, see
 [this page](http://reactivex.io/intro.html) .
 
 In reactive programming it's easier to communicate intentions in marble diagrams. Tests are augmented
diff --git a/exercises/practice/house/.docs/instructions.append.md b/exercises/practice/house/.docs/instructions.append.md
@@ -1,3 +1,3 @@
 # Hints
 
-Try to capture the structure of the song in your code, where you build up the song by composing its parts.
+Try to capture the structure of the song in your code, where you build up the song by composing its parts.
diff --git a/exercises/practice/list-ops/.docs/instructions.append.md b/exercises/practice/list-ops/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
-The `Foldl` and `Foldr` methods are "fold" functions, which is a concept well-known in the functional programming world, but less so in the object-oriented one. If you'd like more background information, check out this [fold](https://en.wikipedia.org/wiki/Fold_(higher-order_function)) page.
+
+The `Foldl` and `Foldr` methods are "fold" functions, which is a concept well-known in the functional programming world, but less so in the object-oriented one. If you'd like more background information, check out this [fold](<https://en.wikipedia.org/wiki/Fold_(higher-order_function)>) page.
diff --git a/exercises/practice/markdown/.docs/instructions.append.md b/exercises/practice/markdown/.docs/instructions.append.md
@@ -1,3 +1,5 @@
 # Hints
+
 For this exercise the following C# feature comes in handy:
-- [String Interpolation](https://msdn.microsoft.com/en-us/library/dn961160.aspx) (C# 6 and up).
+
+- [String Interpolation](https://msdn.microsoft.com/en-us/library/dn961160.aspx) (C# 6 and up).
diff --git a/exercises/practice/nth-prime/.docs/instructions.append.md b/exercises/practice/nth-prime/.docs/instructions.append.md
@@ -1,7 +1,7 @@
 # Hints
 
-For this exercise the following C# feature comes in handy: 
-Enumerables are evaluated lazily.    They allow you to work with an infinite sequence of values.
+For this exercise the following C# feature comes in handy:
+Enumerables are evaluated lazily. They allow you to work with an infinite sequence of values.
 See [this article](https://blogs.msdn.microsoft.com/pedram/2007/06/02/lazy-evaluation-in-c/).
 
-Note: to help speedup calculation, you should not check numbers which you know beforehand will never be prime. For more information, see the [Sieve of Eratosthenes](https://en.wikipedia.org/wiki/Sieve_of_Eratosthenes).
+Note: to help speedup calculation, you should not check numbers which you know beforehand will never be prime. For more information, see the [Sieve of Eratosthenes](https://en.wikipedia.org/wiki/Sieve_of_Eratosthenes).
diff --git a/exercises/practice/nucleotide-count/.docs/instructions.append.md b/exercises/practice/nucleotide-count/.docs/instructions.append.md
@@ -1,3 +1,4 @@
 # Hints
-This exercise requires the use of a Dictionary. For more information see 
-[this page.](https://msdn.microsoft.com/en-us/library/s4ys34ea(v=vs.110).aspx)
+
+This exercise requires the use of a Dictionary. For more information see
+[this page.](<https://msdn.microsoft.com/en-us/library/s4ys34ea(v=vs.110).aspx>)
diff --git a/exercises/practice/palindrome-products/.docs/instructions.append.md b/exercises/practice/palindrome-products/.docs/instructions.append.md
@@ -1,4 +1,4 @@
 # Hints
 
 For this exercise, you will need to create a set of factors using tuples.
-For more information on tuples, see [this link](https://msdn.microsoft.com/en-us/library/system.tuple(v=vs.110).aspx).
+For more information on tuples, see [this link](<https://msdn.microsoft.com/en-us/library/system.tuple(v=vs.110).aspx>).
diff --git a/exercises/practice/proverb/.docs/instructions.append.md b/exercises/practice/proverb/.docs/instructions.append.md
@@ -1,3 +1,3 @@
-# HINTS
+# Hints
 
-Try to capture the structure of the song in your code, where you build up the song by composing its parts.
+Try to capture the structure of the song in your code, where you build up the song by composing its parts.
diff --git a/exercises/practice/react/.docs/instructions.append.md b/exercises/practice/react/.docs/instructions.append.md
@@ -1,3 +1,5 @@
 # Hints
+
 In this exercise the following C# feature is used:
-- [Events](https://msdn.microsoft.com/en-us/library/9aackb16(v=vs.110).aspx).
+
+- [Events](<https://msdn.microsoft.com/en-us/library/9aackb16(v=vs.110).aspx>).
diff --git a/exercises/practice/roman-numerals/.docs/instructions.append.md b/exercises/practice/roman-numerals/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
+
 This exercise requires you to write an extension method. For more information, see [this page](https://msdn.microsoft.com/en-us//library/bb383977.aspx).
diff --git a/exercises/practice/saddle-points/.docs/instructions.append.md b/exercises/practice/saddle-points/.docs/instructions.append.md
@@ -1,4 +1,4 @@
 # Hints
 
 For this exercise, you will need to create a set of factors using tuples.
-For more information on tuples, see [this link](https://msdn.microsoft.com/en-us/library/system.tuple(v=vs.110).aspx).
+For more information on tuples, see [this link](<https://msdn.microsoft.com/en-us/library/system.tuple(v=vs.110).aspx>).
diff --git a/exercises/practice/sgf-parsing/.docs/instructions.append.md b/exercises/practice/sgf-parsing/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
+
 - To parse the text, you could try to use the [Sprache](https://github.com/sprache/Sprache/blob/develop/README.md) library. You can also find a good tutorial [here](https://www.thomaslevesque.com/2017/02/23/easy-text-parsing-in-c-with-sprache/).
diff --git a/exercises/practice/simple-linked-list/.docs/instructions.append.md b/exercises/practice/simple-linked-list/.docs/instructions.append.md
@@ -1,3 +1,4 @@
 # Hints
-This exercise requires you to create a linked list data structure which can be iterated. This requires you to implement the IEnumerable\<T> interface. 
-For more information, see [this page](https://msdn.microsoft.com/en-us/library/9eekhta0(v=vs.110).aspx).
+
+This exercise requires you to create a linked list data structure which can be iterated. This requires you to implement the IEnumerable\<T> interface.
+For more information, see [this page](<https://msdn.microsoft.com/en-us/library/9eekhta0(v=vs.110).aspx>).
diff --git a/exercises/practice/sublist/.docs/instructions.append.md b/exercises/practice/sublist/.docs/instructions.append.md
@@ -1,3 +1,4 @@
 # Hints
+
 To be able to compare data, the IComparable interface is used.
-For more information, see [this page](https://msdn.microsoft.com/en-us/library/system.icomparable(v=vs.110).aspx).
+For more information, see [this page](<https://msdn.microsoft.com/en-us/library/system.icomparable(v=vs.110).aspx>).
diff --git a/exercises/practice/sum-of-multiples/.docs/instructions.append.md b/exercises/practice/sum-of-multiples/.docs/instructions.append.md
@@ -1,3 +1,4 @@
 # Hints
+
 This exercise requires you to process a collection of data. You can simplify your code by using LINQ (Language Integrated Query).
-For more information, see [this page](https://docs.microsoft.com/en-us/dotnet/articles/standard/using-linq).
+For more information, see [this page](https://docs.microsoft.com/en-us/dotnet/articles/standard/using-linq).
diff --git a/exercises/practice/twelve-days/.docs/instructions.append.md b/exercises/practice/twelve-days/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
+
 - Try to capture the structure of the song in your code, where you build up the song by composing its parts.
diff --git a/exercises/practice/variable-length-quantity/.docs/instructions.append.md b/exercises/practice/variable-length-quantity/.docs/instructions.append.md
@@ -1,3 +1,4 @@
 # Hints
+
 This exercise requires you to use bitwise operations. For more information, see [this page]
-(https://msdn.microsoft.com/en-us/library/6a71f45d.aspx). 
+(https://msdn.microsoft.com/en-us/library/6a71f45d.aspx).
diff --git a/exercises/practice/word-search/.docs/instructions.append.md b/exercises/practice/word-search/.docs/instructions.append.md
@@ -1,6 +1,6 @@
-# HINTS
+# Hints
 
-One of the uses of Tuples is returning multiple values from a function.   In this exercise, write
+One of the uses of Tuples is returning multiple values from a function. In this exercise, write
 a function that returns a Tuple (the x- and y- part of a coordinate).
 
-For more information on Tuples, see [this link](https://msdn.microsoft.com/en-us/library/system.tuple(v=vs.110).aspx).
+For more information on Tuples, see [this link](<https://msdn.microsoft.com/en-us/library/system.tuple(v=vs.110).aspx>).
diff --git a/exercises/practice/wordy/.docs/instructions.append.md b/exercises/practice/wordy/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
+
 - To parse the text, you could try to use the [Sprache](https://github.com/sprache/Sprache/blob/develop/README.md) library. You can also find a good tutorial [here](https://www.thomaslevesque.com/2017/02/23/easy-text-parsing-in-c-with-sprache/).
diff --git a/exercises/practice/zebra-puzzle/.docs/instructions.append.md b/exercises/practice/zebra-puzzle/.docs/instructions.append.md
@@ -1,3 +1,4 @@
 # Hints
+
 This exercise requires you to process a collection of data. You can simplify your code by using lazy sequences to improve performance.
 For more information, see [this page](https://xosfaere.wordpress.com/2010/03/21/lazy-evaluation-in-csharp/).
diff --git a/exercises/practice/zipper/.docs/instructions.append.md b/exercises/practice/zipper/.docs/instructions.append.md
@@ -1,2 +1,3 @@
 # Hints
+
 This exercise deals with custom equality. For more information see [this page.](http://www.loganfranken.com/blog/687/overriding-equals-in-c-part-1/)

-Original file line number
+Diff line change
@@ @@ -1,2 +1,3 @@ @@
 # Hints
 -This exercise requires you to use bitwise operations. For more information, see [this page](https://msdn.microsoft.com/en-us/library/6a71f45d.aspx).
++
 +This exercise requires you to use bitwise operations. For more information, see [this page](https://msdn.microsoft.com/en-us/library/6a71f45d.aspx).