WIP

Signed-off-by: alexmerlin <alex.merlin.1985@gmail.com>

Author: alexmerlin

docs/book/v1/component/collection.md

@@ -1,7 +1,11 @@
 # Create Collection
 
+> This page assumes that you have created a Composer "make" script as described on the [Setup page](../setup.md#optional-add-dot-maker-to-composerjson).
+
 > Collections can be created only in APIs.
 
+## Run the command
+
 To create a Collection, use either of the following commands:
 
 ```shell
@@ -14,7 +18,9 @@ OR
 ./vendor/bin/dot-maker collection
 ```
 
-`dot-maker` needs to determine in which module you want to create the new Collection.
+## Identify the target module
+
+`dot-maker` needs to know in which module you want to create the new Collection.
 To determine this, it will prompt you to enter the name of an existing module:
 
 > Existing module name:
@@ -25,7 +31,7 @@ If you input a module name which does not exist (like, "NonExistentModule"), an
 
 and will keep prompting for a valid module name until you provide one.
 
----
+## Name the Collection
 
 Once the target module has been identified, you will be prompted to input a name for the Collection:
 
@@ -43,8 +49,11 @@ If you input the name of an existing Collection (like, "ExistingCollection"), an
 
 > Class "ExistingCollection" already exists at /path/to/project/src/ExistingModule/src/Collection/ExistingCollection.php
 
-If you input a valid name, `dot-maker` will create the Collection and output a success message:
+If you input a valid name (like, "NewCollection"), `dot-maker` will create the Collection and output a success message:
 
 > Created Collection: /path/to/project/src/ExistingModule/src/Collection/NewCollection.php
 
+## Create multiple Collections
+
 To allow the creation of multiple Collections, the process will loop until you leave the name blank.
+Each iteration creates a new Collection under the same module.

docs/book/v1/component/command.md

@@ -1,7 +1,14 @@
 # Create Command
 
+> This page assumes that you have created a Composer "make" script as described on the [Setup page](../setup.md#optional-add-dot-maker-to-composerjson).
+
+> `dot-maker` will look for a matching ServiceInterface in the module (e.g.: BookServiceInterface — BookCommand).
+> If it finds one, it will automatically inject it into the Command.
+
 To create a Command, use either of the following commands:
 
+## Run the command
+
 ```shell
 composer make command
 ```
@@ -12,7 +19,9 @@ OR
 ./vendor/bin/dot-maker command
 ```
 
-`dot-maker` needs to determine in which module you want to create the new Command.
+## Identify the target module
+
+`dot-maker` needs to know in which module you want to create the new Command.
 To determine this, it will prompt you to enter the name of an existing module:
 
 > Existing module name:
@@ -23,7 +32,7 @@ If you input a module name which does not exist (like, "NonExistentModule"), an
 
 and will keep prompting for a valid module name until you provide one.
 
----
+## Name the Command
 
 Once the target module has been identified, you will be prompted to input a name for the Command:
 
@@ -41,11 +50,11 @@ If you input the name of an existing Command (like, "ExistingCommand"), an error
 
 > Class "ExistingCommand" already exists at /path/to/project/src/ExistingModule/src/Command/ExistingCommand.php
 
-If you input a valid name, `dot-maker` will create the Command and output a success message:
+If you input a valid name (like, "NewCommand"), `dot-maker` will create the Command and output a success message:
 
-> Created Collection: /path/to/project/src/ExistingModule/src/Command/NewCommand.php
+> Created Command: /path/to/project/src/ExistingModule/src/Command/NewCommand.php
 
-To allow the creation of multiple Commands, the process will loop until you leave the name blank.
+## Create multiple Commands
 
-> dot-maker will look for a matching ServiceInterface in the module (e.g.: BookServiceInterface — BookCommand).
-> If it finds one, it will automatically inject it into the Command.
+To allow the creation of multiple Commands, the process will loop until you leave the name blank.
+Each iteration creates a new Command under the same module.

docs/book/v1/component/middleware.md

@@ -1,7 +1,11 @@
 # Create Middleware
 
+> This page assumes that you have created a Composer "make" script as described on the [Setup page](../setup.md#optional-add-dot-maker-to-composerjson).
+
 To create a Middleware, use either of the following commands:
 
+## Run the command
+
 ```shell
 composer make middleware
 ```
@@ -12,7 +16,9 @@ OR
 ./vendor/bin/dot-maker middleware
 ```
 
-`dot-maker` needs to determine in which module you want to create the new Middleware.
+## Identify the target module
+
+`dot-maker` needs to know in which module you want to create the new Middleware.
 To determine this, it will prompt you to enter the name of an existing module:
 
 > Existing module name:
@@ -23,7 +29,7 @@ If you input a module name which does not exist (like, "NonExistentModule"), an
 
 and will keep prompting for a valid module name until you provide one.
 
----
+## Name the Middleware
 
 Once the target module has been identified, you will be prompted to input a name for the Middleware:
 
@@ -41,8 +47,11 @@ If you input the name of an existing Middleware (like, "ExistingMiddleware"), an
 
 > Class "ExistingMiddleware" already exists at /path/to/project/src/ExistingModule/src/Middleware/ExistingMiddleware.php
 
-If you input a valid name, `dot-maker` will create the Command and output a success message:
+If you input a valid name (like, "NewMiddleware"), `dot-maker` will create the Command and output a success message:
 
 > Created Middleware: /path/to/project/src/ExistingModule/src/Middleware/NewMiddleware.php
 
+## Create multiple Middleware
+
 To allow the creation of multiple Middleware, the process will loop until you leave the name blank.
+Each iteration creates a new Middleware under the same module.