syntax revamp

docs/ftp_plugin_tutorial.md

@@ -21,7 +21,7 @@ storage-style integration:
 - `selector()` turns folder rows into a follow-up table when the user runs `@N`.
 - `download()` and `download_url()` fetch FTP files into `download-file` output paths.
 - `resolve_pipe_result_download()` lets `@N | add-file -instance ...` materialize a remote FTP file first.
-- `upload()` lets `add-file -plugin ftp -instance <name> -path ...` push a local file to the configured FTP server.
+- `upload()` lets `add-file <local-file> -plugin ftp -instance <name>` push a local file to the configured FTP server.
 
 ## Example config
 
@@ -112,7 +112,7 @@ Why this works:
 Uploading uses the same plugin, through `add-file -plugin ftp -instance <name>`:
 
 ```powershell
-add-file -plugin ftp -instance archive -path C:\Media\report.pdf
+add-file C:\Media\report.pdf -plugin ftp -instance archive
 ```
 
 That sends the file to the selected instance's FTP `base_path` and returns the
@@ -148,5 +148,5 @@ search-file -plugin ftp -instance work "path:/incoming depth:2 *.pdf"
 @1
 @1 | download-file -path C:\Downloads
 @1 | add-file -instance tutorial
-add-file -plugin ftp -instance archive -path C:\Media\report.pdf
+add-file C:\Media\report.pdf -plugin ftp -instance archive
 ```