d Add docs for VerifyAll

Author: ScottBob

approvaltests-tests/src/test/java/org/approvaltests/ApprovalsTest.java

@@ -34,4 +34,12 @@ public void testWrongCall()
       Approvals.verify(b, new Options(new QuietReporter()));
     });
   }
+
+  @Test
+  void verifyAllTemplate() {
+    // begin-snippet: VerifyAllStartingPoint
+    String[] inputs = {"input.value1", "input.value2"};
+    Approvals.verifyAll("TITLE", inputs,s -> "placeholder " + s);
+    // end-snippet
+  }
 }

approvaltests/docs/README.md

@@ -24,6 +24,7 @@
 * have [Consistent Time Zones](how_to/ConsistentTimeZones.md#top) in your tests 
 * separate and test [Data Access and Rendering](how_to/PatternsForTestingDataAccessAndRendering.md#top)
 * show [nulls in verifyAsJson](how_to/ShowNullsInJson.md#top)
+* [test a variety of values](reference/CombinationApprovals.md)
 
 ## Configuration
 

approvaltests/docs/how_to/TestAVarietyOfValues.md

@@ -0,0 +1,53 @@
+<a id="top"></a>
+
+# How to Test a Variety of Values for One Input
+
+<!-- toc -->
+## Contents
+
+  * [When to use Approvals::verifyAll()](#when-to-use-approvalsverifyall)
+  * [Steps](#steps)<!-- endToc -->
+
+## When to use Approvals::verifyAll()
+
+When you want to test a lot of variations for a single input value.
+
+If you have more than one parameter that you want to vary, check out [Testing Combinations](/docs/how_to/TestingCombinations.md#top).
+
+## Steps
+
+1. Copy this starter text.
+
+<!-- snippet: VerifyAllStartingPoint -->
+<a id='snippet-verifyallstartingpoint'></a>
+```java
+String[] inputs = {"input.value1", "input.value2"};
+Approvals.verifyAll("TITLE", inputs,s -> "placeholder " + s);
+```
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/ApprovalsTest.java#L40-L43' title='Snippet source file'>snippet source</a> | <a href='#snippet-verifyallstartingpoint' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+2. Modify the input container for your chosen values.
+3. Run it, and make sure that you have your inputs wired up correctly.
+
+If they are wired up correctly, you will see a file that looks like this: the lambda is responsible for both the execution and formatting of the result.
+
+<!-- snippet: ApprovalsTest.verifyAllTemplate.approved.txt -->
+<a id='snippet-ApprovalsTest.verifyAllTemplate.approved.txt'></a>
+```txt
+TITLE
+
+
+placeholder input.value1
+placeholder input.value2
+```
+<sup><a href='/approvaltests-tests/src/test/java/org/approvaltests/ApprovalsTest.verifyAllTemplate.approved.txt#L1-L5' title='Snippet source file'>snippet source</a> | <a href='#snippet-ApprovalsTest.verifyAllTemplate.approved.txt' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+4. Replace the "placeholder" with a call to the functionality that you want to test.
+5. Change the TITLE to something meaningful
+6. Run it, and approve the output.
+
+---
+
+[Back to User Guide](/doc/README.md#top)

approvaltests/docs/how_to/TestCombinations.md

@@ -7,9 +7,7 @@
 
   * [When to use Combinations](#when-to-use-combinations)
   * [Steps](#steps)
-  * [The Basics](#the-basics)
-    * [Passing in a Reporter](#passing-in-a-reporter)
-  * [C++ Language Versions](#c-language-versions)<!-- endToc -->
+  * [The Basics](#the-basics)<!-- endToc -->
 
 ## When to use Combinations
 

approvaltests/docs/reference/CombinationApprovals.md

@@ -0,0 +1,11 @@
+toc
+
+## Verifying a Variety of Inputs
+
+* [A variety of inputs for a single parameter](/docs/how_to/TestAVarietyOfValues.md)
+* [A variety of inputs for multiple parameters](/docs/how_to/TestCombinations.md)
+* [A minimum set of inputs for multiple parameters](/docs/Features.md#combinationapprovalsverifybestcoveringpairs)
+
+
+
+