Document missing @example annotation (#662)

* Document the @example annotation for Unit tests

* Document missing @example annotation

Since [`@testWith`](Codeception/Codeception#6575) is not supported as of `5.0`, document the `@example` codeception annotation (note: annotation, not the attribute, which is already documented).

* @example update for newer auto-generated docs

* Correct the name of Examples attribute

* Correct the name of Examples attribute

Co-authored-by: Daniel O'Connell <daniel.oconnell@fitchlearning.com>
Co-authored-by: Gintautas Miselis <gintautas@miselis.lt>

Author: 3 people

docs/AdvancedUsage.md

@@ -265,6 +265,32 @@ class EndpointCest
 
 ```
 
+## Example Annotation
+
+As well as the `\Codeception\Attribute\Examples` attribute, available for Cest tests, the `@example` attribute allows you to
+inject test parameters in place of an actual [DataProvider](#dataprovider-attribute) for Unit tests.
+
+```php
+<?php
+namespace Tests\Unit;
+
+class ExampleTest extends \Codeception\Test\Unit
+{
+    /**
+     * @param mixed $value
+     * @example [3.14159]
+     * @example ["a string"]
+     * @example [["this", "is", "an", "array"]]
+     * @example [{"associative": "array"}]
+     */
+    public function testExample($value)
+    {
+        $this->assertNotEmpty($value, "Expected a value");
+    }
+}
+```
+> `@testWith`: as of [Codeception 5.0](https://github.com/Codeception/Codeception/pull/6491), PHPUnit's `@testWith` is no longer supported. `@example` is a good, almost drop-in, replacement.
+
 ## DataProvider Attribute
 
 You can also use the `@dataProvider` annotation for creating dynamic examples for [Cest classes](#Cest-Classes), using a **protected method** for providing example data:

guides/07-AdvancedUsage.md

@@ -258,6 +258,32 @@ class EndpointCest
 
 ```
 
+## Example Annotation
+
+As well as the `\Codeception\Attribute\Examples` attribute, available for Cest tests, the `@example` attribute allows you to
+inject test parameters in place of an actual [DataProvider](#dataprovider-attribute) for Unit tests.
+
+```php
+<?php
+namespace Tests\Unit;
+
+class ExampleTest extends \Codeception\Test\Unit
+{
+    /**
+     * @param mixed $value
+     * @example [3.14159]
+     * @example ["a string"]
+     * @example [["this", "is", "an", "array"]]
+     * @example [{"associative": "array"}]
+     */
+    public function testExample($value)
+    {
+        $this->assertNotEmpty($value, "Expected a value");
+    }
+}
+```
+> `@testWith`: as of [Codeception 5.0](https://github.com/Codeception/Codeception/pull/6491), PHPUnit's `@testWith` is no longer supported. `@example` is a good, almost drop-in, replacement.
+
 ## DataProvider Attribute
 
 You can also use the `@dataProvider` annotation for creating dynamic examples for [Cest classes](#Cest-Classes), using a **protected method** for providing example data: