Fix docs (#261)

Author: serpro69

core/src/integration/kotlin/io/github/serpro69/kfaker/docs/Extras.kt

@@ -273,19 +273,29 @@ class Extras : DescribeSpec({
             )
             // END extras_random_instance_nineteen
 
-            it("should use defaults") {
+            it("should use random values") {
                 // START extras_random_instance_twenty
+                val testClass: TestClass = Faker().randomClass.randomClassInstance()
+                assertNotEquals(Int.MIN_VALUE, testClass.iMin)
+                assertNotEquals(Int.MAX_VALUE, testClass.iMax)
+                assertNotEquals("sometimes a string... is just a string", testClass.s)
+                assertNotEquals(369, testClass.foo.i)
+                // END extras_random_instance_twenty
+            }
+
+            it("should use defaults") {
+                // START extras_random_instance_twenty_one
                 val testClass: TestClass = Faker().randomClass.randomClassInstance {
                     defaultValuesStrategy = USE_DEFAULTS
                 }
                 assertEquals(Int.MIN_VALUE, testClass.iMin)
                 assertEquals(Int.MAX_VALUE, testClass.iMax)
                 assertEquals("sometimes a string... is just a string", testClass.s)
                 assertEquals(369, testClass.foo.i)
-                // END extras_random_instance_twenty
+                // END extras_random_instance_twenty_one
             }
 
-            // START extras_random_instance_twenty_one
+            // START extras_random_instance_twenty_two
             it("should randomly pick a default or a random value") {
                 val testClass: TestClass = Faker().randomClass.randomClassInstance {
                     defaultValuesStrategy = PICK_RANDOMLY
@@ -302,7 +312,7 @@ class Extras : DescribeSpec({
                         && testClass.s == "sometimes a string... is just a string"
                         && testClass.foo.i == 369
                 ))
-                // END extras_random_instance_twenty_one
+                // END extras_random_instance_twenty_two
             }
         }
 

docs/src/orchid/resources/wiki/extras.md

@@ -376,29 +376,47 @@ The above has the following rules:
 
 ### Default values selection
 
-By default, all parameters of a [selected constructor](#deterministic-constructor-selection) would be generated with randomized values. This behavior can be changed with `defaultValuesStrategy` configuration option.
+By default, all parameters of a [selected constructor](#deterministic-constructor-selection) would be generated with randomized values:
 
-One can choose between generating values only for non-optional constructor parameters:
 {% tabs %}
 
 {% kotlin "Kotlin" %}
 {% filter compileAs('md') %}
 ```kotlin
 {% snippet 'extras_random_instance_nineteen' %}
+{% snippet 'extras_random_instance_twenty' %}
 ```
 {% endfilter %}
 {% endkotlin %}
 
 {% endtabs %}
 
-or randomly choosing between picking a default value and a randomly-generated one:
+This behavior can be changed with `defaultValuesStrategy` configuration option.
+
+One can choose between generating values only for non-optional constructor parameters:
 
 {% tabs %}
 
 {% kotlin "Kotlin" %}
 {% filter compileAs('md') %}
 ```kotlin
-{% snippet 'extras_random_instance_twenty' %}
+{% snippet 'extras_random_instance_twenty_one' %}
+```
+{% endfilter %}
+{% endkotlin %}
+
+{% endtabs %}
+
+<br>
+
+...or randomly selecting between a default value and a randomly-generated one:
+
+{% tabs %}
+
+{% kotlin "Kotlin" %}
+{% filter compileAs('md') %}
+```kotlin
+{% snippet 'extras_random_instance_twenty_two' %}
 ```
 {% endfilter %}
 {% endkotlin %}