docs(fs): docs fixes

Review part of: #223

Author: aj-emerich

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

@@ -24,7 +24,7 @@
 @Plugin(
     examples = {
         @Example(
-            title = "Download a list of files and move it to an archive folders",
+            title = "Download a list of files and move them to an archive folder",
             full = true,
             code = """
                 id: fs_ftp_downloads

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

@@ -26,7 +26,7 @@ public interface FtpInterface {
     Property<Proxy.Type> getProxyType();
 
     @Schema(
-        title = "Is the path relative to the users home directory"
+        title = "Is the path relative to the user's home directory"
     )
     Property<Boolean> getRootDir();
 
@@ -36,7 +36,7 @@ public interface FtpInterface {
     Property<Boolean> getPassiveMode();
 
     @Schema(
-        title = "Control that the server ip that emit the request is the same than send response."
+        title = "Ensure the server IP responding matches the one that received the request."
     )
     Property<Boolean> getRemoteIpVerification();
 
@@ -65,15 +65,15 @@ class Options {
         Property<Duration> socketTimeout = Property.ofValue(Duration.ofSeconds(30));
 
         @Schema(
-            title = "the control keep alive timeout.",
-            description = "to ensure the socket be alive after download huge file."
+            title = "The control keep-alive timeout.",
+            description = "Ensures the socket stays alive after downloading a large file."
         )
         @Builder.Default
         Property<Duration> controlKeepAliveTimeout = Property.ofValue(Duration.ofSeconds(30));
 
         @Schema(
-            title = "The control keep alive reply timeout.",
-            description = "to ensure the socket be alive after download huge file."
+            title = "The control keep-alive reply timeout.",
+            description = "Ensures the socket stays alive after downloading a large file."
         )
         @Builder.Default
         Property<Duration> controlKeepAliveReplyTimeout = Property.ofValue(Duration.ofSeconds(30));

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

@@ -27,7 +27,7 @@
 @Plugin(
     examples = {
         @Example(
-            title = "Download a list of files and move it to an archive folders",
+            title = "Download a list of files and move them to an archive folder",
             full = true,
             code = """
                 id: fs_ftps_downloads

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

@@ -106,7 +106,7 @@ public class Downloads extends AbstractLocalTask implements RunnableTask<Downloa
     private Property<String> regExp;
 
     @Schema(
-        title = "List file recursively"
+        title = "List files recursively"
     )
     @Builder.Default
     private Property<Boolean> recursive = Property.ofValue(false);

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

@@ -89,7 +89,7 @@ public class Trigger extends AbstractTrigger implements PollingTriggerInterface,
     private Property<String> from;
 
     @Schema(
-        title = "The destination directory in case off `MOVE` "
+        title = "The destination directory in case of `MOVE`"
     )
     private Property<String> moveDirectory;
 
@@ -101,7 +101,7 @@ public class Trigger extends AbstractTrigger implements PollingTriggerInterface,
     private Property<Boolean> recursive = Property.ofValue(false);
 
     @Schema(
-        title = "The action to do on downloaded files"
+        title = "The action to take on downloaded files"
     )
     @Builder.Default
     private Property<Downloads.Action> action = Property.ofValue(Downloads.Action.NONE);
@@ -220,4 +220,3 @@ public static class Output implements io.kestra.core.models.tasks.Output {
     }
 
 }
-

src/main/java/io/kestra/plugin/fs/local/package-info.java

@@ -1,7 +1,7 @@
 @PluginSubGroup(
-    description = "This sub-group of plugins contains tasks for accessing files using local file system.",
+    description = "This sub-group of plugins contains tasks for accessing files using the local file system.",
     categories = PluginSubGroup.PluginCategory.STORAGE
 )
 package io.kestra.plugin.fs.local;
 
-import io.kestra.core.models.annotations.PluginSubGroup;
+import io.kestra.core.models.annotations.PluginSubGroup;

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

@@ -23,7 +23,7 @@
 @Plugin(
     examples = {
         @Example(
-            title = "Download a list of files and move it to an archive folders",
+            title = "Download a list of files and move them to an archive folder",
             full = true,
             code = """
                 id: fs_sftp_downloads

src/main/java/io/kestra/plugin/fs/sftp/SftpInterface.java

@@ -5,13 +5,13 @@
 
 public interface SftpInterface {
     @Schema(
-        title = "Private keyfile in the PEM file format to connect to a remote server using SSH",
-        description = "To generate a PEM format key from OpenSSH, use the following command: `ssh-keygen -m PEM`"
+        title = "Private key file in the PEM format to connect to a remote server using SSH",
+        description = "To generate a PEM-format key from OpenSSH, use the following command: `ssh-keygen -m PEM`"
     )
     Property<String> getKeyfile();
 
     @Schema(
-        title = "Passphrase of the ssh key"
+        title = "Passphrase for the SSH key"
     )
     Property<String> getPassphrase();
 
@@ -55,12 +55,12 @@ public interface SftpInterface {
     Property<String> getProxyType();
 
     @Schema(
-        title = "Is the path relative to the users home directory"
+        title = "Is the path relative to the user's home directory"
     )
     Property<Boolean> getRootDir();
 
     @Schema(
-        title = "Configures Key exchange algorithm explicitly e. g diffie-hellman-group14-sha1, diffie-hellman-group-exchange-sha256, diffie-hellman-group-exchange-sha1, diffie-hellman-group1-sha1."
+        title = "Configures the key exchange algorithm explicitly (e.g., diffie-hellman-group14-sha1, diffie-hellman-group-exchange-sha256, diffie-hellman-group-exchange-sha1, diffie-hellman-group1-sha1)."
     )
     Property<String> getKeyExchangeAlgorithm();
 }

src/main/java/io/kestra/plugin/fs/smb/package-info.java

@@ -1,6 +1,6 @@
 @PluginSubGroup(
     title = "SMB (Server Message Block)",
-    description = "This sub-group of plugins contains tasks for accessing files using the SMB protocol (Samba for eg.).",
+    description = "This sub-group of plugins contains tasks for accessing files using the SMB protocol (Samba, for example).",
     categories = PluginSubGroup.PluginCategory.STORAGE
 )
 package io.kestra.plugin.fs.smb;

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

@@ -32,7 +32,7 @@ public abstract class Downloads extends AbstractVfsTask implements RunnableTask<
     private Property<String> from;
 
     @Schema(
-        title = "The action to do on downloaded files"
+        title = "The action to take on downloaded files"
     )
     private Property<Downloads.Action> action;
 
@@ -47,7 +47,7 @@ public abstract class Downloads extends AbstractVfsTask implements RunnableTask<
     private Property<String> regExp;
 
     @Schema(
-        title = "List file recursively"
+        title = "List files recursively"
     )
     @Builder.Default
     private Property<Boolean> recursive = Property.ofValue(false);