chore: adds early docs

README.md

@@ -7,3 +7,71 @@ This repository contains the Pest Plugin Stresless.
 - Join us at **[discord.gg/kaHY6p54JH »](https://discord.gg/kaHY6p54JH)** or **[t.me/+kYH5G4d5MV83ODk0 »](https://t.me/+kYH5G4d5MV83ODk0)**
 
 Pest is an open-sourced software licensed under the **[MIT license](https://opensource.org/licenses/MIT)**.
+
+---
+
+The section bellow contains the documentation that will be available at **[pestphp.com/docs/stress-testing](https://pestphp.com/docs/stress-testing)** later on.
+
+---
+title: Stress Testing
+description: Stress Testing is a type of testing that verifies the stability and reliability of your application under realistic or extreme conditions.
+---
+
+# Stress Testing
+
+Stress Testing is a type of testing that verifies the stability and reliability of your application under realistic or extreme conditions. For example, you can use stress testing to verify that your application can handle a large number of requests or that it can handle a large amount of data.
+
+With Pest, you can perform a stress testing in two ways:
+
+- [Using the `stress` command](#the-stress-command): Useful when you want to quickly stress test a specific endpoint, and have a detailed output on the terminal.
+- [Using the `stress()` method](#the-stress-function): Useful when you want to set expectations on a stress test result.
+
+## The `stress` command
+
+To get started with stress testing, you may use the `stress` command. The command receives one argument: the URL to stress test.
+
+```bash
+./vendor/bin/pest stress example.com
+```
+
+By default, the stress test duration will be 10 seconds. However, you may customize this value using the `--duration` option:
+
+```bash
+./vendor/bin/pest stress example.com --duration=30
+```
+
+In addition, the number of concurrent requests will be 1. However, you may also customize this value using the `--concurrency` option:
+
+```bash
+./vendor/bin/pest stress example.com --concurrency=5
+```
+
+The concurrency value represents the number of concurrent requests that will be made to the given URL. For example, if you set the concurrency to 5, Pest will **constantly make 5 concurrent requests** to the given URL until the stress test duration is reached.
+
+You may want to be mindful of the number of concurrent requests you configure. If you configure too many concurrent requests, you may overwhelm your application, server or hit rate limits.
+
+## The `stress()` function
+
+Once you start understanding how stress testing works, you may want to start setting expectations on the stress test result. For example, you may want to verify that the average response time is *always* less than 100ms, and this is where the `stress()` function comes in.
+
+To get started, simply create a regular test and use the `stress()` function to stress test a given URL:
+
+```php
+<?php
+
+use function Pest\Stressless\stress;
+
+it('has a fast response time', function () {
+    $result = stress('example.com')->for(10)->seconds();
+
+    expect($result->responseTime())->toBeLessThan(100);
+});
+```
+
+The `stress()` function return the stress test result, which you can use to set expectations. Here is the list of available methods:
+
+- TODO...
+
+---
+
+TODO