docs(fs): update descriptions

Author: aj-emerich

src/main/java/io/kestra/plugin/fs/ftp/Delete.java

@@ -19,7 +19,8 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Delete a file from an FTP server."
+    title = "Delete a remote FTP file",
+    description = "Removes the specified file on the server. Defaults: port 21, passive mode on, remote IP verification on, paths relative to user home."
 )
 @Plugin(
     examples = {

src/main/java/io/kestra/plugin/fs/ftp/Download.java

@@ -20,7 +20,8 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Download file from an FTP server."
+    title = "Download a file from FTP",
+    description = "Fetches a single remote file to internal storage. Defaults: port 21, passive mode on, remote IP verification on, paths relative to user home."
 )
 @Plugin(
     examples = {

src/main/java/io/kestra/plugin/fs/ftp/Downloads.java

@@ -19,7 +19,8 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Download multiple files from an FTP server."
+    title = "Download multiple files from FTP",
+    description = "Lists matching files then downloads them to internal storage. Respects `maxFiles` (default 25) and optional post-download action (MOVE/DELETE). Defaults: port 21, passive mode on, remote IP verification on, paths relative to user home."
 )
 @Plugin(
     examples = {

src/main/java/io/kestra/plugin/fs/ftp/FtpInterface.java

@@ -11,7 +11,7 @@
 
 public interface FtpInterface {
     @Schema(
-        title = "FTP proxy host"
+        title = "FTP proxy hostname"
     )
     Property<String> getProxyHost();
 
@@ -26,17 +26,20 @@ public interface FtpInterface {
     Property<Proxy.Type> getProxyType();
 
     @Schema(
-        title = "Is the path relative to the user's home directory"
+        title = "Treat path as user home root",
+        description = "If true (default), remote paths are resolved relative to the authenticated user's home directory."
     )
     Property<Boolean> getRootDir();
 
     @Schema(
-        title = "Whether to use a [passive mode](https://www.jscape.com/blog/active-v-s-passive-ftp-simplified). Passive mode is generally considered more secure as it's less likely to encounter issues with NAT and firewalls. Therefore, this property is by default set to `true`. To use active mode instead, set the property to `false`."
+        title = "Use passive data connections",
+        description = "Passive mode avoids most firewall and NAT issues and is enabled by default (`true`). Set to `false` to force active mode."
     )
     Property<Boolean> getPassiveMode();
 
     @Schema(
-        title = "Ensure the server IP responding matches the one that received the request."
+        title = "Verify data channel IP",
+        description = "Ensures the responding server IP matches the control connection to prevent spoofed data channels."
     )
     Property<Boolean> getRemoteIpVerification();
 
@@ -47,33 +50,36 @@ public interface FtpInterface {
     @Jacksonized
     class Options {
         @Schema(
-            title = "The timeout for the initial control connection."
+            title = "Control connection timeout",
+            description = "Maximum time to open the control channel. Default 30s."
         )
         @Builder.Default
         Property<Duration> connectionTimeout = Property.ofValue(Duration.ofSeconds(30));
 
         @Schema(
-            title = "The timeout for opening the data channel."
+            title = "Data channel timeout",
+            description = "Maximum time to open the data socket. Default 30s."
         )
         @Builder.Default
         Property<Duration> dataTimeout = Property.ofValue(Duration.ofSeconds(30));
 
         @Schema(
-            title = "The socket timeout."
+            title = "Socket read timeout",
+            description = "Timeout for socket reads and writes once connected. Default 30s."
         )
         @Builder.Default
         Property<Duration> socketTimeout = Property.ofValue(Duration.ofSeconds(30));
 
         @Schema(
-            title = "The control keep-alive timeout.",
-            description = "Ensures the socket stays alive after downloading a large file."
+            title = "Control keep-alive interval",
+            description = "Sends keep-alive commands during long transfers. Default 30s."
         )
         @Builder.Default
         Property<Duration> controlKeepAliveTimeout = Property.ofValue(Duration.ofSeconds(30));
 
         @Schema(
-            title = "The control keep-alive reply timeout.",
-            description = "Ensures the socket stays alive after downloading a large file."
+            title = "Keep-alive reply timeout",
+            description = "How long to wait for keep-alive responses before failing. Default 30s."
         )
         @Builder.Default
         Property<Duration> controlKeepAliveReplyTimeout = Property.ofValue(Duration.ofSeconds(30));

src/main/java/io/kestra/plugin/fs/ftp/List.java

@@ -19,7 +19,8 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "List files from an FTP server directory."
+    title = "List files in an FTP directory",
+    description = "Lists entries under the given path with optional regexp filter. Defaults: port 21, passive mode on, remote IP verification on, paths relative to user home."
 )
 @Plugin(
     examples = {

src/main/java/io/kestra/plugin/fs/ftp/Move.java

@@ -19,8 +19,8 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Move a file to an FTP server.",
-    description ="If the destination directory doesn't exist, it will be created"
+    title = "Move or rename an FTP file",
+    description = "Moves/renames a remote file; destination directories are created when missing. Defaults: port 21, passive mode on, remote IP verification on, paths relative to user home."
 )
 @Plugin(
     examples = {

src/main/java/io/kestra/plugin/fs/ftp/Trigger.java

@@ -19,7 +19,8 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Trigger a flow as soon as new files are detected in a given FTP server's directory."
+    title = "Trigger on new FTP files",
+    description = "Polls a remote directory on the interval and starts a Flow when new files appear. Defaults: port 21, passive mode on, remote IP verification on, paths relative to user home. Use `action` MOVE/DELETE to avoid reprocessing."
 )
 @Plugin(
     examples = {

src/main/java/io/kestra/plugin/fs/ftp/Upload.java

@@ -19,7 +19,8 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Upload a file to an FTP server."
+    title = "Upload a file to FTP",
+    description = "Pushes one local file to the remote path. Defaults: port 21, passive mode on, remote IP verification on, paths relative to user home."
 )
 @Plugin(
     examples = {

src/main/java/io/kestra/plugin/fs/ftp/Uploads.java

@@ -19,7 +19,8 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-        title = "Upload files to an FTP server's directory."
+        title = "Upload multiple files to FTP",
+        description = "Uploads each provided file to the target directory. Defaults: port 21, passive mode on, remote IP verification on, paths relative to user home."
 )
 @Plugin(
         examples = {

src/main/java/io/kestra/plugin/fs/ftps/Delete.java

@@ -22,7 +22,8 @@
 @Getter
 @NoArgsConstructor
 @Schema(
-    title = "Delete a file from an FTPS server."
+    title = "Delete a remote FTPS file",
+    description = "Removes the specified file over FTPS. Defaults: port 990, EXPLICIT mode, PROT P data channel, passive mode on, remote IP verification on, paths relative to user home. `insecureTrustAllCertificates` skips SSL checks for testing."
 )
 @Plugin(
     examples = {