Improve documentation for exception handling and method tracing

Author: roxblnfk

docs/plugins/assert.md

@@ -374,7 +374,22 @@ public function throwsOnInvalidInput(): void
 You can narrow down the expected exception using chain methods:
 
 <signature compact h="4" name="\Testo\Assert\Api\ExpectedException::fromMethod(string $class, string $method): self">
-<short>Specifies that the exception should be thrown from a specific method (the throw point, not the creation point).</short>
+<short>Checks that the specified method is present in the exception's call stack.</short>
+<description>
+Can be called multiple times to require several methods in the call chain.
+
+::: info
+The call stack in an exception is captured at the moment of its creation, not when it is thrown. So this checks where the exception was created, not where it was rethrown via `throw`.
+:::
+</description>
+<example>
+```php
+// Make sure the exception originated in validation,
+// not rethrown from somewhere else
+Expect::exception(ValidationException::class)
+    ->fromMethod(UserValidator::class, 'validate');
+```
+</example>
 </signature>
 
 <signature compact h="4" name="\Testo\Assert\Api\ExpectedException::withMessage(string $message): self">

docs/writing-tests.md

@@ -117,7 +117,7 @@ Instead of base classes or magic methods, Testo bets on attributes.
     public function sum(int $a, int $b, int $expected): void { /* ... */ }
     ```
 
-- Instead of `Expect::exception` you can use the `#[ExpectException]` attribute, which is slightly more compact and adds clarity:
+- Instead of <func>\Testo\Expect::exception()</func> you can use the `#[ExpectException]` attribute, which is slightly more compact and adds clarity:
 
     ```php
     #[ExpectException(\InsufficientFundsException::class)]

ru/docs/plugins/assert.md

@@ -373,7 +373,22 @@ public function throwsOnInvalidInput(): void
 С помощью цепочки методов можно уточнить, какое именно исключение ожидается:
 
 <signature compact h="4" name="\Testo\Assert\Api\ExpectedException::fromMethod(string $class, string $method): self">
-<short>Указывает, что исключение должно быть выброшено из конкретного метода (точка выброса, а не создания).</short>
+<short>Проверяет, что указанный метод присутствует в стеке вызовов исключения.</short>
+<description>
+Метод можно вызывать несколько раз, добавляя несколько мест для проверки.
+
+::: info
+Стек вызовов в исключении заполняется в момент его создания, а не выброса. Таким образом, мы проверяем именно место создания, а не проброс через `throw`.
+:::
+</description>
+<example>
+```php
+// Убеждаемся, что исключение возникло именно в валидации,
+// а не было проброшено откуда-то ещё
+Expect::exception(ValidationException::class)
+    ->fromMethod(UserValidator::class, 'validate');
+```
+</example>
 </signature>
 
 <signature compact h="4" name="\Testo\Assert\Api\ExpectedException::withMessage(string $message): self">

ru/docs/writing-tests.md

@@ -116,7 +116,7 @@ Expect::notLeaks($connection);
     public function sum(int $a, int $b, int $expected): void { /* ... */ }
     ```
 
-- А вместо `Expect::exception` можно использовать атрибут `#[ExpectException]`, который просто немного компактнее и добавляет наглядности:
+- А вместо <func>\Testo\Expect::exception()</func> можно использовать атрибут `#[ExpectException]`, который просто немного компактнее и добавляет наглядности:
 
     ```php
     #[ExpectException(\InsufficientFundsException::class)]