From 508e998ff6d9d4ad59f35f7357060c9567879650 Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Wed, 24 Apr 2024 12:04:53 +0200
Subject: [PATCH 01/11] Add Throws for exceptions to the docs

---
 .../2010-05-02-throwing-exceptions.markdown   | 31 +++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index ade4d02b..0b500895 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -3,7 +3,34 @@ title: Throwing exceptions
 layout: post
 ---
 
-[Callbacks](/help/callbacks) can be used to throw exceptions when a member is called.
+The `Throws` and `ThrowsAsync` helpers in the namespace NSubstitute.ExceptionExtensions could be use d
+
+<!--
+```requiredcode
+public interface ICalculator { int Add(int a, int b); }
+ICalculator calculator;
+[SetUp] public void SetUp() { calculator = Substitute.For<ICalculator>(); }
+```
+-->
+
+
+```csharp
+//For non-voids:
+calculator.Add(-1, -1).Throws(new Exception()); // Or .Throws<Exception>();
+
+//For voids and non-voids:
+calculator
+    .When(x => x.Add(-2, -2))
+    .Throw(x => new Exception()); // Or .Throws<Exception>();
+
+//Both calls will now throw.
+Assert.Throws<Exception>(() => calculator.Add(-1, -1));
+Assert.Throws<Exception>(() => calculator.Add(-2, -2));
+```
+
+
+### Returns
+Another way is to use the underlyning method, .Returns. See also [Callbacks](/help/callbacks) 
 
 <!--
 ```requiredcode
@@ -25,4 +52,4 @@ calculator
 //Both calls will now throw.
 Assert.Throws<Exception>(() => calculator.Add(-1, -1));
 Assert.Throws<Exception>(() => calculator.Add(-2, -2));
-```
\ No newline at end of file
+```

From b0f8fbb2aff6769fdee7a72f4085f62f898edda0 Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Wed, 24 Apr 2024 12:06:40 +0200
Subject: [PATCH 02/11] Update 2010-05-02-throwing-exceptions.markdown

---
 docs/help/_posts/2010-05-02-throwing-exceptions.markdown | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index 0b500895..a963c712 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -28,9 +28,8 @@ Assert.Throws<Exception>(() => calculator.Add(-1, -1));
 Assert.Throws<Exception>(() => calculator.Add(-2, -2));
 ```
 
-
 ### Returns
-Another way is to use the underlyning method, .Returns. See also [Callbacks](/help/callbacks) 
+Another way is to use the underlying method, `.Returns`. See also [Callbacks](/help/callbacks) 
 
 <!--
 ```requiredcode

From 1b23cd07e7e5411a1a0662408f5004d57f306db4 Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Wed, 24 Apr 2024 12:31:53 +0200
Subject: [PATCH 03/11] Update 2010-05-02-throwing-exceptions.markdown

---
 .../_posts/2010-05-02-throwing-exceptions.markdown    | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index a963c712..a911d957 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -3,8 +3,6 @@ title: Throwing exceptions
 layout: post
 ---
 
-The `Throws` and `ThrowsAsync` helpers in the namespace NSubstitute.ExceptionExtensions could be use d
-
 <!--
 ```requiredcode
 public interface ICalculator { int Add(int a, int b); }
@@ -13,6 +11,7 @@ ICalculator calculator;
 ```
 -->
 
+The `Throws` and `ThrowsAsync` helpers in the namespace NSubstitute.ExceptionExtensions could be use d
 
 ```csharp
 //For non-voids:
@@ -31,14 +30,6 @@ Assert.Throws<Exception>(() => calculator.Add(-2, -2));
 ### Returns
 Another way is to use the underlying method, `.Returns`. See also [Callbacks](/help/callbacks) 
 
-<!--
-```requiredcode
-public interface ICalculator { int Add(int a, int b); }
-ICalculator calculator;
-[SetUp] public void SetUp() { calculator = Substitute.For<ICalculator>(); }
-```
--->
-
 ```csharp
 //For non-voids:
 calculator.Add(-1, -1).Returns(x => { throw new Exception(); });

From b72e497ca561f44926d02f9f0cc9e2cecd45685c Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Wed, 24 Apr 2024 13:13:47 +0200
Subject: [PATCH 04/11] Using in requiredcode

---
 docs/help/_posts/2010-05-02-throwing-exceptions.markdown | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index a911d957..213aa4d6 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -5,6 +5,7 @@ layout: post
 
 <!--
 ```requiredcode
+using NSubstitute.ExceptionExtensions;
 public interface ICalculator { int Add(int a, int b); }
 ICalculator calculator;
 [SetUp] public void SetUp() { calculator = Substitute.For<ICalculator>(); }

From 8312e28f6e78fae7e33eac7979dc676b68b9e595 Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Wed, 24 Apr 2024 16:42:09 +0200
Subject: [PATCH 05/11] Move using 1

---
 docs/help/_posts/2010-05-02-throwing-exceptions.markdown | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index 213aa4d6..a911d957 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -5,7 +5,6 @@ layout: post
 
 <!--
 ```requiredcode
-using NSubstitute.ExceptionExtensions;
 public interface ICalculator { int Add(int a, int b); }
 ICalculator calculator;
 [SetUp] public void SetUp() { calculator = Substitute.For<ICalculator>(); }

From d7c296549754ec8c856b34aaf415dbd67f7e386b Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Wed, 24 Apr 2024 16:43:17 +0200
Subject: [PATCH 06/11] Update ExtractDocs.fs

---
 build/ExtractDocs.fs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/build/ExtractDocs.fs b/build/ExtractDocs.fs
index 466b927c..f7a56663 100644
--- a/build/ExtractDocs.fs
+++ b/build/ExtractDocs.fs
@@ -37,6 +37,7 @@ using System.Collections.Generic;
 using System.ComponentModel;
 using NSubstitute.Extensions;
 using NSubstitute.Compatibility;
+using NSubstitute.ExceptionExtensions;
 
 namespace NSubstitute.Samples {
     public class Tests_%s {

From 1aaf1a82e7ae0270594a5aa7b2dff5ec033cb9d8 Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Thu, 25 Apr 2024 14:11:18 +0200
Subject: [PATCH 07/11] Update 2010-05-02-throwing-exceptions.markdown

---
 docs/help/_posts/2010-05-02-throwing-exceptions.markdown | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index a911d957..25a6b0af 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -15,12 +15,12 @@ The `Throws` and `ThrowsAsync` helpers in the namespace NSubstitute.ExceptionExt
 
 ```csharp
 //For non-voids:
-calculator.Add(-1, -1).Throws(new Exception()); // Or .Throws<Exception>();
+calculator.Add(-1, -1).Throws(new Exception()); // Or .Throw<Exception>() - don't use Throw*s*
 
 //For voids and non-voids:
 calculator
     .When(x => x.Add(-2, -2))
-    .Throw(x => new Exception()); // Or .Throws<Exception>();
+    .Throw(x => new Exception()); // Or .Throw<Exception>(); 
 
 //Both calls will now throw.
 Assert.Throws<Exception>(() => calculator.Add(-1, -1));

From 5e410b44608aab1f32b6347656a02fbb8686d62b Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Sun, 28 Apr 2024 23:11:30 +0200
Subject: [PATCH 08/11] Applied suggestion

---
 docs/help/_posts/2010-05-02-throwing-exceptions.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index 25a6b0af..c25a0f09 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -11,7 +11,7 @@ ICalculator calculator;
 ```
 -->
 
-The `Throws` and `ThrowsAsync` helpers in the namespace NSubstitute.ExceptionExtensions could be use d
+The `Throws` and `ThrowsAsync` helpers in the `NSubstitute.ExceptionExtensions` namespace can be used to throw exceptions when a member is called.
 
 ```csharp
 //For non-voids:

From bcd13b8d3ff9b12e2e292de7e240138f1a6117dd Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Sun, 28 Apr 2024 23:13:02 +0200
Subject: [PATCH 09/11] Fix comment about throw*s*

---
 docs/help/_posts/2010-05-02-throwing-exceptions.markdown | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index c25a0f09..5257ebf2 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -15,12 +15,12 @@ The `Throws` and `ThrowsAsync` helpers in the `NSubstitute.ExceptionExtensions`
 
 ```csharp
 //For non-voids:
-calculator.Add(-1, -1).Throws(new Exception()); // Or .Throw<Exception>() - don't use Throw*s*
+calculator.Add(-1, -1).Throws(new Exception()); // Or .Throw<Exception>()
 
 //For voids and non-voids:
 calculator
     .When(x => x.Add(-2, -2))
-    .Throw(x => new Exception()); // Or .Throw<Exception>(); 
+    .Throw(x => new Exception()); // Or .Throw<Exception>() -  - don't use .Throw*s* in this case
 
 //Both calls will now throw.
 Assert.Throws<Exception>(() => calculator.Add(-1, -1));

From d947986b034b5a7c1deca7469884170335b8b406 Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Sun, 28 Apr 2024 23:14:41 +0200
Subject: [PATCH 10/11] Added .

---
 docs/help/_posts/2010-05-02-throwing-exceptions.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index 5257ebf2..7c29d801 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -28,7 +28,7 @@ Assert.Throws<Exception>(() => calculator.Add(-2, -2));
 ```
 
 ### Returns
-Another way is to use the underlying method, `.Returns`. See also [Callbacks](/help/callbacks) 
+Another way is to use the underlying method, `.Returns`. See also [Callbacks](/help/callbacks).
 
 ```csharp
 //For non-voids:

From 184d0b4b77f950187e84a67d2a9cdd5997968b1d Mon Sep 17 00:00:00 2001
From: Julian Verdurmen <5808377+304NotModified@users.noreply.github.com>
Date: Sun, 28 Apr 2024 23:16:03 +0200
Subject: [PATCH 11/11] Fix comment

---
 docs/help/_posts/2010-05-02-throwing-exceptions.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
index 7c29d801..b7ef3adc 100644
--- a/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
+++ b/docs/help/_posts/2010-05-02-throwing-exceptions.markdown
@@ -15,7 +15,7 @@ The `Throws` and `ThrowsAsync` helpers in the `NSubstitute.ExceptionExtensions`
 
 ```csharp
 //For non-voids:
-calculator.Add(-1, -1).Throws(new Exception()); // Or .Throw<Exception>()
+calculator.Add(-1, -1).Throws(new Exception()); // Or .Throws<Exception>()
 
 //For voids and non-voids:
 calculator