Repository: kestra-io/kestra (java)

Issue:
Replace Deprecated annotation with a friendlier message 
### Issue description

![image](https://github.com/user-attachments/assets/45b58ae6-2985-460c-8d33-58a851f288ad)

Extend the annotation with sth like: "This feature is deprecated and will be removed in the future. We encourage you to migrate to the new plugin, but you can still use the deprecated version."

Pull request description:
feat(core): change deprecated notice in the doc
Fixes #4395

Patch:
diff --git a/core/src/main/resources/docs/task.peb b/core/src/main/resources/docs/task.peb
index 027e745d9..e46dbaa1d 100644
--- a/core/src/main/resources/docs/task.peb
+++ b/core/src/main/resources/docs/task.peb
@@ -19,7 +19,8 @@ icon: {{ icon }}
 
 {% if deprecated %}
 ::alert{type="warning"}
-⚠ Deprecated {% if replacement %}use `{{ replacement }}` instead {%- endif %}
+⚠ This feature is deprecated and will be removed in the future. We encourage you to migrate to the new plugin, but you can still use the deprecated version.
+{% if replacement %}Please use `{{ replacement }}` instead. {%- endif %}
 ::
 {%- endif %}
 


Test patch:
diff --git a/core/src/test/java/io/kestra/core/docs/DocumentationGeneratorTest.java b/core/src/test/java/io/kestra/core/docs/DocumentationGeneratorTest.java
index c4d72f22a..fff0f58c4 100644
--- a/core/src/test/java/io/kestra/core/docs/DocumentationGeneratorTest.java
+++ b/core/src/test/java/io/kestra/core/docs/DocumentationGeneratorTest.java
@@ -132,7 +132,7 @@ class DocumentationGeneratorTest {
         String render = DocumentationGenerator.render(doc);
 
         assertThat(render, containsString("Echo"));
-        assertThat(render, containsString("Deprecated"));
+        assertThat(render, containsString("This feature is deprecated and will be removed in the future"));
     }
 
     @SuppressWarnings("unchecked")