docs: write docs

README.md

@@ -38,121 +38,9 @@ Register the namespaces inside your `composer.json`:
 ```
 Run `composer dump-autoload` and everything is set up for using Laravel Beyond commands. 
 
-## Commands
-### Overview
-#### Application
-- [`beyond:make:command`](#beyondmakecommand)
-- `beyond:make:controller`
-- `beyond:make:policy`
-- `beyond:make:process`
-- `beyond:make:query`
-- `beyond:make:request`
-- `beyond:make:resource`
-- `beyond:make:rule`
-
-#### Domain
-- [`beyond:make:action`](#beyondmakeaction)
-- [`beyond:make:builder`](#beyondmakebuilder)
-- [`beyond:make:collection`](#beyondmakecollection)
-- `beyond:make:data`
-- `beyond:make:enum`
-- `beyond:make:event`
-- `beyond:make:job`
-- `beyond:make:listener`
-- `beyond:make:model`
-- `beyond:make:observer`
-
-### Detail
-#### `beyond:make:action`
-Creates a new action. An action does run one specific task, e.g. storing or updating a model.
-If you need to do additional tasks like logging you should wrap those inside their own action 
-or (maybe better) consider using a process.
-
-##### Signature
-`beyond:make:action {name} {--force}`
-
-| Parameters | Description            |
-|------------|------------------------|
-| name       | The name of you action |
-
-| Flags   | Description             |
-|---------|-------------------------|
-| --force | Overwrite existing file |
----
-#### `beyond:make:builder`
-Creates a new Laravel Eloquent builder for a model.
-
-> [!NOTE]
-> You need to add the builder to your model
-> ```
-> public function newEloquentBuilder($q): YourBuilder
-> {
->       return new YourBuilder($q);
-> }
-> ```
-
-> [!NOTE]
-> For proper IDE support add the following docblock to you model
-> ```
-> /**
->  * @method static YourBuilder query()
->  */
-> class User extends Model
-> ```
-
-##### Signature
-`beyond:make:builder {name} {--force}`
-
-| Parameters | Description             |
-|------------|-------------------------|
-| name       | The name of you builder |
-
-| Flags   | Description             |
-|---------|-------------------------|
-| --force | Overwrite existing file |
----
-#### `beyond:make:collection`
-Creates a new Laravel collection for a model.
-
-> [!NOTE]
-> You need to add the collection to your model
-> ```
-> public function newCollection($q): YourCollection
-> {
->       return new YourCollection($q);
-> }
-> ```
-
-##### Signature
-`beyond:make:collection {name} {--force}`
-
-| Parameters | Description                |
-|------------|----------------------------|
-| name       | The name of you collection |
-
-| Flags   | Description             |
-|---------|-------------------------|
-| --force | Overwrite existing file |
----
-#### `beyond:make:command`
-Creates a new Laravel command.
-
-> [!NOTE]
-> You need to add the command at `App\Console\Kernel`.
-
-##### Signature
-`beyond:make:command {name} {--command=command:name} {--force}`
-
-| Parameters | Description             |
-|------------|-------------------------|
-| name       | The name of you command |
-
-| Flags     | Description             |
-|-----------|-------------------------|
-| --command | Define the command name |
-| --force   | Overwrite existing file |
----
-
+## Documentation
+Take a look at our documentation inside [`/docs`](docs/README.md) to learn about the available 
+commands and how to use them.
 
 ## Directory structure
 ```

docs/README.md

@@ -0,0 +1,24 @@
+# Documentation
+
+## Commands
+### Application
+- [`beyond:make:command`](commands/make-command.md)
+- `beyond:make:controller`
+- `beyond:make:policy`
+- `beyond:make:process`
+- `beyond:make:query`
+- `beyond:make:request`
+- `beyond:make:resource`
+- `beyond:make:rule`
+
+### Domain
+- [`beyond:make:action`](commands/make-action.md)
+- [`beyond:make:builder`](commands/make-builder.md)
+- [`beyond:make:collection`](commands/make-collection.md)
+- `beyond:make:data`
+- `beyond:make:enum`
+- `beyond:make:event`
+- `beyond:make:job`
+- `beyond:make:listener`
+- `beyond:make:model`
+- `beyond:make:observer`

docs/commands/make-action.md

@@ -0,0 +1,15 @@
+# `beyond:make:action`
+Creates a new action. An action does run one specific task, e.g. storing or updating a model.
+If you need to do additional tasks like logging you should wrap those inside their own action
+or (maybe better) consider using a [process](make-process.md).
+
+## Signature
+`beyond:make:action {name} {--force}`
+
+| Parameters | Description            |
+|------------|------------------------|
+| name       | The name of you action |
+
+| Flags   | Description             |
+|---------|-------------------------|
+| --force | Overwrite existing file |

docs/commands/make-builder.md

@@ -0,0 +1,31 @@
+# `beyond:make:builder`
+Creates a new Laravel Eloquent builder for a model.
+
+> [!NOTE]
+> You need to add the builder to your model
+> ```
+> public function newEloquentBuilder($q): YourBuilder
+> {
+>       return new YourBuilder($q);
+> }
+> ```
+
+> [!NOTE]
+> For proper IDE support add the following docblock to you model
+> ```
+> /**
+>  * @method static YourBuilder query()
+>  */
+> class User extends Model
+> ```
+
+## Signature
+`beyond:make:builder {name} {--force}`
+
+| Parameters | Description             |
+|------------|-------------------------|
+| name       | The name of you builder |
+
+| Flags   | Description             |
+|---------|-------------------------|
+| --force | Overwrite existing file |

docs/commands/make-collection.md

@@ -0,0 +1,22 @@
+# `beyond:make:collection`
+Creates a new Laravel collection for a model.
+
+> [!NOTE]
+> You need to add the collection to your model
+> ```
+> public function newCollection($q): YourCollection
+> {
+>       return new YourCollection($q);
+> }
+> ```
+
+## Signature
+`beyond:make:collection {name} {--force}`
+
+| Parameters | Description                |
+|------------|----------------------------|
+| name       | The name of you collection |
+
+| Flags   | Description             |
+|---------|-------------------------|
+| --force | Overwrite existing file |

docs/commands/make-command.md

@@ -0,0 +1,17 @@
+# `beyond:make:command`
+Creates a new Laravel command.
+
+> [!NOTE]
+> You need to add the command at `App\Console\Kernel`.
+
+## Signature
+`beyond:make:command {name} {--command=command:name} {--force}`
+
+| Parameters | Description             |
+|------------|-------------------------|
+| name       | The name of you command |
+
+| Flags     | Description             |
+|-----------|-------------------------|
+| --command | Define the command name |
+| --force   | Overwrite existing file |

docs/commands/make-process.md

@@ -0,0 +1 @@
+# `beyond:make:process`