docs(features): update upload.mdx (#1924)

* docs(features): update `upload.mdx`

* fix: format

* update: usage

* Apply suggestion from vasfvitor's review.

Co-authored-by: Vitor Ayres <[email protected]>

---------

Co-authored-by: Vitor Ayres <[email protected]>

Author: dreyfus92

src/content/docs/features/upload.mdx

@@ -3,12 +3,87 @@ title: Upload
 description: File uploads through HTTP.
 ---
 
-import Stub from '@components/Stub.astro';
 import PluginLinks from '@components/PluginLinks.astro';
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+import CommandTabs from '@components/CommandTabs.astro';
 
 <PluginLinks plugin="upload" />
 
-<Stub>
-	Based on
-	https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/upload
-</Stub>
+Upload files from disk to a remote server over HTTP. Download files from a remote HTTP server to disk.
+
+## Setup
+
+_This plugin requires a Rust version of at least **1.75**_
+
+<Tabs>
+	<TabItem label="Automatic">
+
+    Use your project's package manager to add the dependency:
+
+    <CommandTabs
+    npm="npm run tauri add upload"
+    yarn="yarn run tauri add upload"
+    pnpm="pnpm tauri add upload"
+    cargo="cargo tauri add upload"
+    />
+
+    </TabItem>
+    <TabItem label="Manual">
+
+    	<Steps>
+
+    	1. Run `cargo add tauri-plugin-upload` to add the plugin to the project's dependencies in `Cargo.toml`.
+
+    	2. Modify `lib.rs` to initialize the plugin:
+
+    		```rust title="src-tauri/src/lib.rs" ins={5}
+    		#[cfg_attr(mobile, tauri::mobile_entry_point)]
+    		pb fn run() {
+    			tauri::Builder::default()
+    				// Initialize the plugin
+    				.plugin(tauri_plugin_upload::init())
+        			.run(tauri::generate_context!())
+        			.expect("error while running tauri application");
+    		}
+    		```
+
+    	3. Install the JavaScript Guest bindings using your preferred JavaScript package manager:
+
+    		<CommandTabs
+    			npm="npm install @tauri-apps/plugin-upload"
+    			yarn="yarn add @tauri-apps/plugin-upload"
+    			pnpm="pnpm add @tauri-apps/plugin-upload"
+    		/>
+
+    	</Steps>
+    </TabItem>
+
+</Tabs>
+
+## Usage
+
+Once you've completed the registration and setup process for the plugin, you can access all of its APIs through the JavaScript guest bindings.
+
+Here's an example of how you can use the plugin to upload and download files:
+
+```js
+import { upload } from 'tauri-plugin-upload-api';
+
+upload(
+	'https://example.com/file-upload',
+	'./path/to/my/file.txt',
+	(progress, total) => console.log(`Uploaded ${progress} of ${total} bytes`), // a callback that will be called with the upload progress
+	{ 'Content-Type': 'text/plain' } // optional headers to send with the request
+);
+```
+
+```js
+import { download } from 'tauri-plugin-upload-api';
+
+download(
+	'https://example.com/file-download-link',
+	'./path/to/save/my/file.txt',
+	(progress, total) => console.log(`Downloaded ${progress} of ${total} bytes`), // a callback that will be called with the download progress
+	{ 'Content-Type': 'text/plain' } // optional headers to send with the request
+);
+```