Add documentation for JGiven configuration annotation

Signed-off-by: l-1squared <[email protected]>

Author: l-1squared

docs/report_generation.adoc

@@ -217,3 +217,6 @@ jgiven.report.text.color
 jgiven.report.filterStackTrace=true
 ----
 Configuration defined via Java system properties will take precedence over values in the configuration file.
+
+=== Configuration class
+Finally, JGiven allows to set a custom derivative of `AbstractJGivenConfiguration` on the class level via the `@JGivenConfiguration` annotation. Tag configuration, formatter configuration and a default `xref:_overriding_the_default_reporting[@As provider]` provider can be set there.

docs/stages.adoc

@@ -36,9 +36,10 @@ I fill out the registration form
 ----
 The nested steps will appear as a collapsible group in the HTML report.
 
+[#_overriding_the_default_reporting]
 === Overriding the Default Reporting
 
-Sometimes it is necessary to override the default way of the step reporting. For example, if you want to use special characters that are not allowed in Java methods names, such as `(`, `+`, or `%`. You can then use the `@As` annotation to specify what JGiven should put into the report.
+Sometimes it is necessary to override the default way of the step reporting. For example, if you want to use special characters that are not allowed in Java methods names, such as `(`, `+`, or `%`, you can then use the `@As` annotation to specify what JGiven should put into the report.
 
 For example, if you define the following step method:
 
@@ -66,6 +67,7 @@ public MyStage some_step() {
     return self();
 }
 ----
+In addition, the `@As` annotation allows declaring an `AsProvider` that handles the step name generation. A default provider can be set via `@JGivenConfiguration` annotation in the class referenced there.
 
 === Completely Hide Steps
 

jgiven-core/src/main/java/com/tngtech/jgiven/annotation/JGivenConfiguration.java

@@ -12,6 +12,7 @@
  * <ul>
  *     <li>Tags</li>
  *     <li>Global formatter</li>
+ *     <li>Default {@link As} provider</li>
  * </ul>
  */
 @Retention( RetentionPolicy.RUNTIME )