Add dataset labels section to data-providers documentation

Author: roxblnfk

docs/data-providers.md

@@ -22,6 +22,16 @@ public function testSum(int $a, int $b, int $expected): void
 
 Each `DataSet` is an array of arguments passed to the test method. The test runs three times with different values.
 
+### Dataset Labels
+
+The second argument is an optional label. It appears in reports and helps identify which scenario failed:
+
+```php
+#[DataSet([1, 1, 2], 'positive numbers')]
+#[DataSet([-1, -1, -2], 'negative numbers')]
+#[DataSet([0, 0, 0], 'zeros')]
+public function testSum(int $a, int $b, int $expected): void { ... }
+```
 
 ## DataProvider
 
@@ -80,3 +90,18 @@ public function testUser($data): void { ... }
 ```
 
 Invokable objects are particularly useful for separating data loading logic. For example, loading test cases from JSON/CSV files into a dedicated class keeps your test code clean.
+
+### Dataset Labels
+
+Labels are set via string array keys:
+
+```php
+public function userDataProvider(): array
+{
+    return [
+        'valid email' => ['test@example.com', true],
+        'invalid format' => ['not-an-email', false],
+        'empty string' => ['', false],
+    ];
+}
+```

ru/docs/data-providers.md

@@ -22,6 +22,16 @@ public function testSum(int $a, int $b, int $expected): void
 
 Каждый `DataSet` — массив аргументов, которые передаются в тестовый метод. Тест запустится три раза с разными значениями.
 
+### Метки датасетов
+
+Второй аргумент — опциональная метка. Отображается в отчётах и помогает понять, какой именно сценарий упал:
+
+```php
+#[DataSet([1, 1, 2], 'positive numbers')]
+#[DataSet([-1, -1, -2], 'negative numbers')]
+#[DataSet([0, 0, 0], 'zeros')]
+public function testSum(int $a, int $b, int $expected): void { ... }
+```
 
 ## DataProvider
 
@@ -80,3 +90,18 @@ public function testUser($data): void { ... }
 ```
 
 Вызываемые объекты особенно полезны для разделения логики загрузки данных. Например, загрузка тестов из JSON/CSV файлов в выделенный класс позволяет сохранить код тестов чистым.
+
+### Метки датасетов
+
+Метки задаются через строковые ключи массива:
+
+```php
+public function userDataProvider(): array
+{
+    return [
+        'valid email' => ['test@example.com', true],
+        'invalid format' => ['not-an-email', false],
+        'empty string' => ['', false],
+    ];
+}
+```