d updated markdown snippets

Author: actions-user

README.md

@@ -15,6 +15,7 @@
   * [Examples](#examples)
   * [Approved File Artifacts](#approved-file-artifacts)
   * [More Info](#more-info)
+    * [No Checked Exceptions Philosophy](#no-checked-exceptions-philosophy)
   * [LICENSE](#license)
   * [Developer notes](#developer-notes)<!-- endToc -->
 

approvaltests/docs/explanations/NoCheckedExceptions.md

@@ -4,11 +4,12 @@
 
 <!-- toc -->
 ## Contents
- 
-  * [Paintables](#paintables)
-    * [Why](#why)
-  * [How To](#how-to)
-    * [create an animated gif](#create-an-animated-gif)<!-- endToc -->
+
+  * [Checked Exceptions Were a Mistake](#checked-exceptions-were-a-mistake)
+  * [Mechanics](#mechanics)
+    * [ObjectUtils.throwAsError](#objectutilsthrowaserror)
+      * [ObjectUtils.throwAsError(() -> methodThatThrowsException(parameters))](#objectutilsthrowaserror---methodthatthrowsexceptionparameters)
+      * [throw ObjectUtils.throwAsError(myCheckedException)](#throw-objectutilsthrowaserrormycheckedexception)<!-- endToc -->
 
 ## Checked Exceptions Were a Mistake
 Java was the first (and last) language to experiment with checked exceptions. The fact that no other language has adopted this "feature" should be strong enough evidence that it was a mistake.
@@ -27,15 +28,55 @@ If you have a single line that throws a checked exception, you can easily wrap i
 #### throw ObjectUtils.throwAsError(myCheckedException)
 If you want to rethrow from a try/catch block this method will rethrow what is passed-in wrapped in an unchecked exception (if needed). This method also states that it returns an unchecked exception allowing you to pretend to throw it, so you can easily compile code without having to add unnecessary return statements. For example:
 
-snippet: throw_as_error_does_not_compile
+<!-- snippet: throw_as_error_does_not_compile -->
+<a id='snippet-throw_as_error_does_not_compile'></a>
+```java
+try
+{
+  return methodThatThrowsCheckedException();
+}
+catch (Exception e)
+{
+  ObjectUtils.throwAsError(e); // Does not compile. Missing "return" statement
+}
+```
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ThrowAsErrorExamples.java#L15-L24' title='Snippet source file'>snippet source</a> | <a href='#snippet-throw_as_error_does_not_compile' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
 
 Even though this would run, it won't compile. So instead you have to write the code like:
 
-snippet: throw_as_error_with_return
+<!-- snippet: throw_as_error_with_return -->
+<a id='snippet-throw_as_error_with_return'></a>
+```java
+try
+{
+  return methodThatThrowsCheckedException();
+}
+catch (Exception e)
+{
+  ObjectUtils.throwAsError(e);
+  return null; // This is never reached because the line above always throws an exception
+}
+```
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ThrowAsErrorExamples.java#L29-L39' title='Snippet source file'>snippet source</a> | <a href='#snippet-throw_as_error_with_return' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
 
 Since this return statement is never reached, instead we write it as throwing an exception returned from the method call.
 
-snippet: throw_as_error_with_throw
+<!-- snippet: throw_as_error_with_throw -->
+<a id='snippet-throw_as_error_with_throw'></a>
+```java
+try
+{
+  return methodThatThrowsCheckedException();
+}
+catch (Exception e)
+{
+  throw ObjectUtils.throwAsError(e);
+}
+```
+<sup><a href='/approvaltests-util-tests/src/test/java/com/spun/util/ThrowAsErrorExamples.java#L43-L52' title='Snippet source file'>snippet source</a> | <a href='#snippet-throw_as_error_with_throw' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->