application: improved info about attributes, added #[Deprecated]

Author: dg

application/cs/presenters.texy

@@ -493,6 +493,14 @@ class MyPresenter extends Nette\Application\UI\Presenter
 Je důležité zdůraznit, že pokud povolíte metodu `OPTIONS`, musíte ji následně také patřičně obsloužit v rámci svého presenteru. Metoda je často používána jako tzv. preflight request, který prohlížeč automaticky odesílá před skutečným požadavkem, když je potřeba zjistit, zda je požadavek povolený z hlediska CORS (Cross-Origin Resource Sharing) politiky. Pokud metodu povolíte, ale neimplementujete správnou odpověď, může to vést k nekonzistencím a potenciálním bezpečnostním problémům.
 
 
+Označení zastaralých akcí .{data-version:3.2.3}
+-----------------------------------------------
+
+Atribut `#[Deprecated]` slouží k označení akcí, signálů nebo celých presenterů, které jsou zastaralé a měly by být v budoucnu odstraněny. Při generování odkazů na takto označené části aplikace Nette vyhodí varování, které vývojáře upozorní.
+
+Atribut lze aplikovat jak na celou třídu presenteru, tak na jednotlivé metody `action<Action>()`, `render<View>()` a `handle<Signal>()`.
+
+
 Další četba
 ===========
 

application/en/presenters.texy

@@ -493,6 +493,14 @@ class MyPresenter extends Nette\Application\UI\Presenter
 It's important to emphasize that if you enable the `OPTIONS` method, you must subsequently handle it appropriately within your presenter. This method is often used as a so-called preflight request, which the browser automatically sends before the actual request when it's necessary to determine if the request is permissible according to the CORS (Cross-Origin Resource Sharing) policy. If you enable the method but don't implement the correct response, it can lead to inconsistencies and potential security problems.
 
 
+Marking Deprecated Actions .{data-version:3.2.3}
+------------------------------------------------
+
+The `#[Deprecated]` attribute marks actions, signals, or entire presenters as deprecated and scheduled for future removal. When generating links to deprecated parts of the application, Nette throws a warning to alert developers.
+
+You can apply the attribute to either the entire presenter class or to individual `action<Action>()`, `render<View>()`, and `handle<Signal>()` methods.
+
+
 Further Reading
 ===============
 

nette/cs/vulnerability-protection.texy

@@ -48,18 +48,7 @@ Nette Framework **automaticky chrání formuláře a signály v presenterech** p
 $form->allowCrossOrigin();
 ```
 
-nebo v případě signálu přidejte anotaci `@crossOrigin`:
-
-```php
-/**
- * @crossOrigin
- */
-public function handleXyz()
-{
-}
-```
-
-V Nette Application 3.2 můžete použít také atributy:
+nebo v případě signálu přidejte atribut:
 
 ```php
 use Nette\Application\Attributes\Requires;

nette/en/vulnerability-protection.texy

@@ -48,18 +48,7 @@ Nette Framework **automatically protects forms and signals in presenters** again
 $form->allowCrossOrigin();
 ```
 
-or in the case of a signal, add the `@crossOrigin` annotation:
-
-```php
-/**
- * @crossOrigin
- */
-public function handleXyz()
-{
-}
-```
-
-In Nette Application 3.2, you can also use attributes:
+or in the case of a signal, add the attribute:
 
 ```php
 use Nette\Application\Attributes\Requires;