docs: put actual first in Assert::same() examples

Testo's Assert::same() takes ($actual, $expected), the reverse of PHPUnit, yet 42 examples across EN and RU passed the expected value first.

Assisted-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: roxblnfk

docs/ai/best-practices.md

@@ -37,7 +37,7 @@ final class UserServiceTest
 
         $user = $service->create('Alice', 'alice@example.com');
 
-        Assert::same('Alice', $user->name);
+        Assert::same($user->name, 'Alice');
     }
 
     /**
@@ -66,7 +66,7 @@ public function rejectsAgesOutsideRange(int $age, bool $accepted): void
 {
     $service = new UserService(new InMemoryRepository());
 
-    Assert::same($accepted, $service->canRegister($age));
+    Assert::same($service->canRegister($age), $accepted);
 }
 ```
 
@@ -76,7 +76,7 @@ Reach for `\Testo\Data\DataProvider` when the cases need code to produce — gen
 #[DataProvider('emailFixtures')]
 public function validatesEmail(string $email, bool $expected): void
 {
-    Assert::same($expected, UserService::isValidEmail($email));
+    Assert::same(UserService::isValidEmail($email), $expected);
 }
 
 public static function emailFixtures(): iterable
@@ -116,7 +116,7 @@ When positive and negative cases come from separate providers, pair each with it
 #[Covers(UserService::class, 'isValidEmail')]
 public function validatesEmail(string $email, bool $expected): void
 {
-    Assert::same($expected, UserService::isValidEmail($email));
+    Assert::same(UserService::isValidEmail($email), $expected);
 }
 ```
 

docs/bridge/revolt.md

@@ -42,7 +42,7 @@ public function resolvesAfterDelay(): void
     $suspension = EventLoop::getSuspension();
     EventLoop::delay(0.1, static fn() => $suspension->resume('ready'));
 
-    Assert::same('ready', $suspension->suspend()); // the loop keeps spinning while we wait
+    Assert::same($suspension->suspend(), 'ready'); // the loop keeps spinning while we wait
 }
 ```
 

docs/plugins/codecov.md

@@ -304,7 +304,7 @@ public function smokeTest(): void
 {
     // Test runs, but coverage is not collected
     $response = $this->app->get('/health');
-    Assert::same(200, $response->statusCode);
+    Assert::same($response->statusCode, 200);
 }
 ```
 </example>

docs/plugins/data.md

@@ -20,7 +20,7 @@ Data providers let you run one test with different sets of input data. Each set
 #[DataSet([0, 0, 0])]
 public function testSum(int $a, int $b, int $expected): void
 {
-    Assert::same($expected, $a + $b);
+    Assert::same($a + $b, $expected);
 }
 ```
 </example>
@@ -46,7 +46,7 @@ public function testSum(int $a, int $b, int $expected): void { ... }
 public function testUserValidation(string $email, bool $expected): void
 {
     $isValid = $this->validator->validate($email);
-    Assert::same($expected, $isValid);
+    Assert::same($isValid, $expected);
 }
 
 public function userDataProvider(): iterable
@@ -122,7 +122,7 @@ The first item from the first provider joins with the first from the second, sec
 public function testUserPermissions(string $login, string $password, array $permissions): void
 {
     $user = $this->auth->login($login, $password);
-    Assert::same($permissions, $user->getPermissions());
+    Assert::same($user->getPermissions(), $permissions);
 }
 
 // credentials: [['admin', 'secret'], ['guest', '1234']]
@@ -261,7 +261,7 @@ For complex scenarios, providers can be nested:
 public function testAccessControl(string $user, string $role, bool $expected): void
 {
     $this->actAs($user)->withRole($role);
-    Assert::same($expected, $this->canAccess('/admin'));
+    Assert::same($this->canAccess('/admin'), $expected);
 }
 
 // users × roles produces all user-role combinations,

docs/plugins/inline.md

@@ -79,7 +79,7 @@ For complex checks, pass a closure as the second parameter, where you can perfor
 #[TestInline(
     arguments: ['john.doe@example.com'],
     result: static function (User $user) {
-        Assert::same('john.doe@example.com', $user->email);
+        Assert::same($user->email, 'john.doe@example.com');
         Assert::true($user->isActive);
         Assert::notNull($user->createdAt);
     }

docs/plugins/lifecycle.md

@@ -123,7 +123,7 @@ final class DatabaseTest
     public function insertsRecord(): void
     {
         self::$connection->insert('users', ['name' => 'John']);
-        Assert::same(1, self::$connection->count('users'));
+        Assert::same(self::$connection->count('users'), 1);
     }
 }
 ```

docs/plugins/repeat.md

@@ -24,7 +24,7 @@ Run the same test 5 times — any single failure fails the whole test:
 public function orderCalculationIsStable(): void
 {
     $order = new Order([new Item('A', 10), new Item('B', 20)]);
-    Assert::same(30, $order->total());
+    Assert::same($order->total(), 30);
 }
 ```
 </example>
@@ -36,7 +36,7 @@ Tolerate up to two failures out of ten — useful when the underlying system is
 public function externalServiceReturnsExpectedShape(): void
 {
     $response = HttpClient::get('https://api.example.com/users/1');
-    Assert::same(200, $response->statusCode);
+    Assert::same($response->statusCode, 200);
 }
 ```
 </example>

docs/plugins/retry.md

@@ -23,7 +23,7 @@ Retry a test up to 3 times:
 public function flakyExternalService(): void
 {
     $response = HttpClient::get('https://api.example.com/health');
-    Assert::same(200, $response->statusCode);
+    Assert::same($response->statusCode, 200);
 }
 ```
 </example>

docs/theory/mutation-testing.md

@@ -171,10 +171,10 @@ Now write the "obvious" test suite, one test per branch:
 ```php
 public function testGrades(): void
 {
-    Assert::same('A', gradeScore(95));
-    Assert::same('B', gradeScore(85));
-    Assert::same('C', gradeScore(75));
-    Assert::same('F', gradeScore(50));
+    Assert::same(gradeScore(95), 'A');
+    Assert::same(gradeScore(85), 'B');
+    Assert::same(gradeScore(75), 'C');
+    Assert::same(gradeScore(50), 'F');
 }
 ```
 
@@ -197,9 +197,9 @@ Let's close it:
 ```php
 public function testGradeBoundaries(): void
 {
-    Assert::same('A', gradeScore(90)); // lower bound for A
-    Assert::same('B', gradeScore(80)); // lower bound for B
-    Assert::same('C', gradeScore(70)); // lower bound for C
+    Assert::same(gradeScore(90), 'A'); // lower bound for A
+    Assert::same(gradeScore(80), 'B'); // lower bound for B
+    Assert::same(gradeScore(70), 'C'); // lower bound for C
 }
 ```
 

ru/docs/bridge/revolt.md

@@ -40,7 +40,7 @@ public function resolvesAfterDelay(): void
     $suspension = EventLoop::getSuspension();
     EventLoop::delay(0.1, static fn() => $suspension->resume('ready'));
 
-    Assert::same('ready', $suspension->suspend()); // цикл крутится, пока мы ждём
+    Assert::same($suspension->suspend(), 'ready'); // цикл крутится, пока мы ждём
 }
 ```