[R2] Adding workflow for using Rclone to upload to R2 (#21227)

* Initiating tutorial

* Adding Rclone tutorial.

* Iterating feedback

* Offloading config into into the Rclone example.
Cutting down wording in the Uploads chapter.

* Adding back useful code comment

* Adding emphasis on uploading concurrently.

* Implementing feedback

* Catching capitalisations in titles

* Informing users that they can upload via API in
the opening sentence.

Author: Oxyjun

src/content/docs/r2/examples/rclone.mdx

@@ -1,27 +1,43 @@
 ---
-title: rclone
+title: Rclone
 pcx_content_type: example
 ---
 
-import { Render } from "~/components";
+import { Render, Steps } from "~/components";
 
 <Render file="keys" />
 <br />
 
+Rclone is a command-line tool which manages files on cloud storage. You can use rclone to upload objects to R2 concurrently.
+
+## Configure rclone
+
 With [`rclone`](https://rclone.org/install/) installed, you may run [`rclone config`](https://rclone.org/s3/) to configure a new S3 storage provider. You will be prompted with a series of questions for the new provider details.
 
 :::note[Recommendation]
-
 It is recommended that you choose a unique provider name and then rely on all default answers to the prompts.
 
 This will create a `rclone` configuration file, which you can then modify with the preset configuration given below.
 :::
 
-:::note
+<Steps>
+1. Create new remote by selecting `n`.
+2. Select a name for the new remote. For example, use `r2`.
+3. Select the `Amazon S3 Compliant Storage Providers` storage type.
+4. Select `Cloudflare R2 storage` for the provider.
+5. Select whether you would like to enter AWS credentials manually, or get it from the runtime environment.
+6. Enter the AWS Access Key ID.
+7. Enter AWS Secret Access Key (password).
+8. Select the region to connect to (optional).
+9. Select the S3 API endpoint.
+</Steps>
 
+:::note
 Ensure you are running `rclone` v1.59 or greater ([rclone downloads](https://beta.rclone.org/)). Versions prior to v1.59 may return `HTTP 401: Unauthorized` errors, as earlier versions of `rclone` do not strictly align to the S3 specification in all cases.
 :::
 
+### Edit an existing rclone configuration
+
 If you have already configured `rclone` in the past, you may run `rclone config file` to print the location of your `rclone` configuration file:
 
 ```sh

src/content/docs/r2/objects/upload-objects.mdx

@@ -5,16 +5,44 @@ sidebar:
   order: 1
 ---
 
-You can upload objects to your bucket from the Cloudflare dashboard or using the Wrangler.
+import { Steps, Tabs, TabItem } from "~/components"
+
+You can upload objects to your bucket from using API (both [Workers Binding API](/r2/api/workers/workers-api-reference/) or [compatible S3 API](/r2/api/s3/api/)), rclone, Cloudflare dashboard, or Wrangler.
+
+## Upload objects via Rclone
+
+Rclone is a command-line tool which manages files on cloud storage. You can use rclone to upload objects to R2. Rclone is useful if you wish to upload multiple objects concurrently.
+
+To use rclone, install it onto your machine using their official documentation - [Install rclone](https://rclone.org/install/).
+
+Upload your files to R2 using the `rclone copy` command.
+
+```sh
+# Upload a single file
+rclone copy /path/to/local/file.txt r2:bucket_name
+
+# Upload everything in a directory
+rclone copy /path/to/local/folder r2:bucket_name
+```
+
+Verify that your files have been uploaded by listing the objects stored in the destination R2 bucket using `rclone ls` command.
+
+```sh
+rclone ls r2:bucket_name
+```
+
+For more information, refer to our [rclone example](/r2/examples/rclone/).
 
 ## Upload objects via the Cloudflare dashboard
 
 To upload objects to your bucket from the Cloudflare dashboard:
 
+<Steps>
 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select **R2**.
 2. From the **R2** page in the dashboard, locate and select your bucket.
 3. Select **Upload**.
 4. Choose to either drag and drop your file into the upload area or **select from computer**.
+</Steps>
 
 You will receive a confirmation message after a successful upload.
 
@@ -38,3 +66,9 @@ Upload complete.
 ```
 
 You can set the `Content-Type` (MIME type), `Content-Disposition`, `Cache-Control` and other HTTP header metadata through optional flags.
+
+:::note
+Wrangler's `object put` command only allows you to upload one object at a time.
+
+Use rclone if you wish to upload multiple objects to R2.
+:::