Merge branch 'staging'

Author: mychidarko

src/docs/auth/index.md

@@ -6,6 +6,10 @@ Numerous web applications offer their users a means to authenticate and access t
 
 Leaf provides a lightweight but very powerful authentication system to handle all the complexities of authentication in a few lines of code. We understand that authentication is a critical part of your application, so we've made it as simple and secure as possible.
 
+::: warning Docs version
+This documentation covers Auth v3 and above. If you're using an older version, you can check the documentation [hosted here](https://v3.leafphp.dev/modules/auth/).
+:::
+
 ## Setting up
 
 You can install Leaf Auth using the Leaf CLI:

src/docs/utils/fs.md

@@ -1,10 +1,14 @@
-# Filesystem / Cloud Storage
-
 <!-- markdownlint-disable no-inline-html -->
-<!-- # File Storage System -->
+<!-- # Filesystem / Cloud Storage -->
+
+# File Storage System
 
 A file storage system is a system used to store and manage files. It's a crucial part of most applications, as it helps you create, read, update, store and delete files effectively. Leaf provides a simple and easy-to-use file storage system that allows you to work with files on your server or in the cloud.
 
+::: warning Docs version
+This documentation covers FS v2 and above. If you're using an older version, you can check the documentation [hosted here](https://v3.leafphp.dev/modules/fs/).
+:::
+
 ## Installation
 
 You can quickly install Leaf's file storage system through composer or the leaf cli.
@@ -173,20 +177,21 @@ One amazing thing about the `upload()` method is that it can detect the file typ
 ```php
 $uploaded = storage()->upload('fileToUpload', 'path/to/uploads', [
   'maxSize' => 1024 * 1024, // 1MB
-  'allowedTypes' => 'image',
+  'allowedTypes' => ['image'],
   'allowedExtensions' => ['jpg', 'png', 'gif'],
-  'rename' => true,
-  'force' => true,
-  'overwrite' => false,
   'validate' => true,
+  'mode' => 0777,
+  'rename' => false,
+  'recursive' => false,
+  'overwrite' => false,
 ]);
 ```
 
 This is a list of config options for the `upload()` method:
 
 | Config Name  | Description                                                  |                                                                       Possible Values |
 | :----------- | :----------------------------------------------------------- | ------------------------------------------------------------------------------------: |
-| force        | If `true`, Leaf will create the folder if it doesn't exist   |                                                                       `true`, `false` |
+| mode        | Permissions to create your destination folder if it doesn't exist   | Any permissions accepted by mkdir() |
 | overwrite    | If `true`, Leaf will overwrite the file if it already exists |                                                                       `true`, `false` |
 | rename       | If `true`, Leaf will rename the file if it already exists    |                                                                       `true`, `false` |
 | validate     | If `true`, Leaf will validate the file before uploading      |                                                                       `true`, `false` |

src/docs/utils/testing.md

@@ -4,6 +4,10 @@ Testing helps you and your team build Leaf apps faster by making sure that new f
 
 Since you might need to setup a project for rapid prototyping and deployment, we don't add any tests to the default Leaf installation. However, we have Alchemy, a user-friendly tool that simplifies your testing, code styling checks, and code coverage reports with a single command.
 
+::: warning Docs version
+This documentation covers Alchemy v2 and above. If you're using an older version, you can check the documentation [hosted here](https://v3.leafphp.dev/docs/tooling/testing.html).
+:::
+
 ## Setting up
 
 Leaf CLI will always ask if you want to add Alchemy to your project when you create a new project. If you already have a project and want to add Alchemy, you can do so by running the following command: