[TASK] Update functional tests examples (TYPO3-Documentation#4784)

Mainly:
- Remove superfluous "Test Case" comment
- Add `declare(strict_types=1);` as best practise
- Use `@test` annotation as best practise like the Core does
- Add `void` return type as best practise
- Add `typo3/testing-framework` as requirement to have code completion in the PHP files

Note: As this is set to be merged also to 12.4, the `@test` annotation is used (instead of the `#[Test]` annotation)
to be compatible with testing framework v7 and v8 (v7 is compatible with phpunit 9/10
and TYPO3 v11/v12, v8 is compatible with phpunit 10/11 and TYPO3 v12/v13).
In a follow-up only to main (v13) this will be changed to the annotation.

Releases: main, 12.4

Documentation/Testing/FunctionalTesting/_FunctionalTests/_SomeTest.php

@@ -1,19 +1,21 @@
 <?php
 
+declare(strict_types=1);
+
 namespace MyVendor\MyExtension\Tests\Functional;
 
 use TYPO3\TestingFramework\Core\Functional\FunctionalTestCase;
 
-/**
- * Test case
- */
 class SomeTest extends FunctionalTestCase
 {
     protected array $coreExtensionsToLoad = [
         'workspaces',
     ];
 
-    public function testSomethingWithWorkspaces()
+    /**
+     * @test
+     */
+    public function somethingWithWorkspaces(): void
     {
         //...
     }

Documentation/Testing/FunctionalTesting/_FunctionalTests/_SomeTestConfiguration.php

@@ -1,13 +1,12 @@
 <?php
 
+declare(strict_types=1);
+
 namespace MyVendor\MyExtension\Tests\Functional;
 
 use Symfony\Component\Mailer\Transport\NullTransport;
 use TYPO3\TestingFramework\Core\Functional\FunctionalTestCase;
 
-/**
- * Test case
- */
 class SomeTest extends FunctionalTestCase
 {
     protected array $configurationToUseInTestInstance = [
@@ -16,7 +15,10 @@ class SomeTest extends FunctionalTestCase
         ],
     ];
 
-    public function testSomething()
+    /**
+     * @test
+     */
+    public function something(): void
     {
         //...
     }

Documentation/Testing/FunctionalTesting/_FunctionalTests/_SomeTestExtensions.php

@@ -1,20 +1,22 @@
 <?php
 
+declare(strict_types=1);
+
 namespace MyVendor\MyExtension\Tests\Functional;
 
 use TYPO3\TestingFramework\Core\Functional\FunctionalTestCase;
 
-/**
- * Test case
- */
 class SomeTest extends FunctionalTestCase
 {
     protected array $testExtensionsToLoad = [
         'typo3conf/ext/some_extension/Tests/Functional/Fixtures/Extensions/test_extension',
         'typo3conf/ext/base_extension',
     ];
 
-    public function testSomethingWithExtensions()
+    /**
+     * @test
+     */
+    public function somethingWithExtensions(): void
     {
         //...
     }

Documentation/Testing/FunctionalTesting/_FunctionalTests/_SomeTestFiles.php

@@ -1,18 +1,21 @@
 <?php
 
+declare(strict_types=1);
+
 namespace MyVendor\MyExtension\Tests\Functional;
 
 use TYPO3\TestingFramework\Core\Functional\FunctionalTestCase;
 
-/**
- * Test case
- */
 class SomeTest extends FunctionalTestCase
 {
     protected array $pathsToLinkInTestInstance = [
         'typo3/sysext/impexp/Tests/Functional/Fixtures/Folders/fileadmin/user_upload/typo3_image2.jpg' => 'fileadmin/user_upload/typo3_image2.jpg',
     ];
-    public function testSomethingWithFiles()
+
+    /**
+     * @test
+     */
+    public function somethingWithFiles(): void
     {
         //...
     }

Documentation/Testing/FunctionalTesting/_FunctionalTests/_SomeTestFrontend.php

@@ -1,15 +1,17 @@
 <?php
 
+declare(strict_types=1);
+
 namespace MyVendor\MyExtension\Tests\Functional;
 
 use TYPO3\TestingFramework\Core\Functional\FunctionalTestCase;
 
-/**
- * Test case
- */
 class SomeTest extends FunctionalTestCase
 {
-    public function testSomethingWithWorkspaces()
+    /**
+     * @test
+     */
+    public function somethingWithWorkspaces(): void
     {
         $this->setUpFrontendRootPage(
             1,

Documentation/Testing/FunctionalTesting/_FunctionalTests/_SomeTestImportDataSet.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace MyVendor\MyExtension\Tests\Functional;
 
 use TYPO3\TestingFramework\Core\Functional\FunctionalTestCase;

composer.json

@@ -48,7 +48,8 @@
         "typo3/cms-t3editor": "dev-main as 13.1",
         "typo3/cms-tstemplate": "dev-main as 13.1",
         "typo3/cms-viewpage": "dev-main as 13.1",
-        "typo3/cms-workspaces": "dev-main as 13.1"
+        "typo3/cms-workspaces": "dev-main as 13.1",
+        "typo3/testing-framework": "^8.2"
     },
     "minimum-stability": "dev",
     "prefer-stable": true,