diff --git a/src/main/java/io/kestra/plugin/gitlab/MergeRequest.java b/src/main/java/io/kestra/plugin/gitlab/MergeRequest.java
index 5b2dc03..8bbbbcd 100644
--- a/src/main/java/io/kestra/plugin/gitlab/MergeRequest.java
+++ b/src/main/java/io/kestra/plugin/gitlab/MergeRequest.java
@@ -24,8 +24,9 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Create a GitLab merge request",
-    description = "Create a new merger request in a GitLab project"
+    title = "Create a GitLab merge request.",
+    description = "Create a new merge request in a GitLab project. " +
+        "You need to provide a valid GitLab project ID and a personal access token with the necessary permissions."
 )
 @Plugin(examples = {
     @Example(
diff --git a/src/main/java/io/kestra/plugin/gitlab/issues/Create.java b/src/main/java/io/kestra/plugin/gitlab/issues/Create.java
index 595bd9f..67fed32 100644
--- a/src/main/java/io/kestra/plugin/gitlab/issues/Create.java
+++ b/src/main/java/io/kestra/plugin/gitlab/issues/Create.java
@@ -26,8 +26,9 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Create a GitLab issue",
-    description = "Create a new issue in a GitLab project"
+    title = "Create a GitLab issue.",
+    description = "Create a new issue in a GitLab project. " +
+        "You need to provide a valid GitLab project ID and a personal access token with the necessary permissions."
 )
 @Plugin(examples = {
     @Example(
diff --git a/src/main/java/io/kestra/plugin/gitlab/issues/Search.java b/src/main/java/io/kestra/plugin/gitlab/issues/Search.java
index 5110914..b47e9ad 100644
--- a/src/main/java/io/kestra/plugin/gitlab/issues/Search.java
+++ b/src/main/java/io/kestra/plugin/gitlab/issues/Search.java
@@ -25,8 +25,9 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Search GitLab issues",
-    description = "Search for issues in a GitLab project"
+    title = "Search GitLab issues.",
+    description = "Search for issues in a GitLab project. " +
+        "You need to provide a valid GitLab project ID and a personal access token with the necessary permissions."
 )
 @Plugin(examples = {
     @Example(