Fix typos and update code formatting in documentation

Author: dvlpp

docs/guide/artisan-generators.md

@@ -34,7 +34,7 @@ php artisan sharp:make:policy <class_name> [--entity-only]
 php artisan sharp:make:entity-command <class_name> [--model=<model_name>,--wizard,--form]
 
 # Generate an Instance Command
-php artisan sharp:make:intance-command <class_name> [--model=<model_name>,--wizard,--form]
+php artisan sharp:make:instance-command <class_name> [--model=<model_name>,--wizard,--form]
 
 # Generate a Entity List Filter
 php artisan sharp:make:entity-list-filter <class_name> [--required,--multiple,--date-range,--check]

docs/guide/authentication-2fa.md

@@ -11,7 +11,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
             ->enable2faByNotification()
             // or ->enable2faByTotp()
             // or ->enable2faCustom()
-            // [...]
+            // ...
     }
 }
 ```
@@ -36,7 +36,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
     {
         $config
             ->enable2faCustom(\App\Sharp\My2faNotificationHandler::class)
-            // [...]
+            // ...
     }
 }
 ```
@@ -75,7 +75,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
     {
         $config
             ->enable2faByTotp()
-            // [...]
+            // ...
     }
 }
 ```

docs/guide/authentication-passkeys.md

@@ -18,7 +18,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
     {
         $config
             ->enablePasskeys()
-            // [...]
+            // ...
     }
 }
 ```
@@ -45,7 +45,7 @@ class ProfileSingleShow extends SharpSingleShow
     protected function buildShowFields(FieldsContainer $showFields): void
     {
         $showFields
-            // [...]
+            // ...
             ->addField(
                 SharpShowEntityListField::make(PasskeyEntity::class)
                     ->setLabel('Passkeys')
@@ -56,7 +56,7 @@ class ProfileSingleShow extends SharpSingleShow
     {
         $showLayout
             ->addSection('', function (ShowLayoutSection $section) {
-                // [...]
+                // ...
             })
             ->addEntityListSection(PasskeyEntity::class);
     }

docs/guide/authentication.md

@@ -15,7 +15,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
             ->setLoginAttributes('login', 'pwd')
             ->setUserDisplayAttribute('last_name')
             ->setUserAvatarAttribute('avatar_url')
-            // [...]
+            // ...
     }
 }
 ```
@@ -37,7 +37,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
         $config
             ->suggestRememberMeOnLoginForm()
             ->enableLoginRateLimiting(maxAttemps: 3)
-            // [...]
+            // ...
     }
 }
 ```
@@ -53,7 +53,7 @@ A simple way to restrict access to Sharp is to define the `viewSharp` global Gat
 ```php
 class SharpServiceProvider extends SharpAppServiceProvider
 {
-    // [...]
+    // ...
 
     public function declareAccessGate(): void
     {
@@ -75,7 +75,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
     {
         $config
             ->setAuthCustomGuard('sharp')
-            // [...]
+            // ...
     }
 }
 ```
@@ -93,7 +93,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
     {
         $config
             ->enableForgottenPassword()
-            // [...]
+            // ...
     }
 }
 ```
@@ -112,7 +112,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
             ->enableForgottenPassword(resetCallback: function ($user, $password) {
                 $user->updatePasswordAfterReset($password);
             })
-            // [...]
+            // ...
     }
 }
 ```
@@ -126,7 +126,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
     {
         $config
             ->enableForgottenPassword(broker: MyPasswordBroker::class)
-            // [...]
+            // ...
     }
 }
 ```
@@ -140,7 +140,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
     {
         $config
             ->enableForgottenPassword(showResetLinkInLoginForm: false)
-            // [...]
+            // ...
     }
 }
 ```
@@ -215,7 +215,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
     {
         $config
             ->enableImpersonation()
-            // [...]
+            // ...
     }
 }
 ```
@@ -286,7 +286,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
         $config
             ->redirectLoginToUrl('/my_login')
             ->redirectLogoutToUrl('/my_logout')
-            // [...]
+            // ...
     }
 }
 ```

docs/guide/building-dashboard.md

@@ -27,7 +27,7 @@ This method is meant to host the code responsible for the declaration and config
 ```php
 class SalesDashboard extends SharpDashboard
 {
-    // [...]
+    // ...
     function buildWidgets(WidgetsContainer $widgetsContainer): void
     {
         $widgetsContainer

docs/guide/building-entity-list.md

@@ -22,7 +22,7 @@ First let's write the applicative class, and make it extend `Code16\Sharp\Entity
 - `buildList(EntityListFieldsContainer $fields)` for the structure,
 - and `getListData()` for the actual data of the list.
 
-There are a two more optional methods, for the list config and instance deletion. 
+There are two more optional methods, for the list config and instance deletion. 
 Each one is detailed here:
 
 ### `buildList(EntityListFieldsContainer $fields)`
@@ -44,7 +44,7 @@ class ProductList extends SharpEntityList
             )
             ->addField(/* ... */);
     }
-    // [...]
+    // ...
 }
 ```
 
@@ -103,7 +103,7 @@ class ProductList extends SharpEntityList
             ]
         ];
     }
-    // [...]
+    // ...
 }
 ```
 
@@ -229,7 +229,7 @@ Here is the full list of available methods:
 
 - `configureDefaultSort(string $sortBy, string $sortDir = "asc")`: `EntityListQueryParams $queryParams` will be filled with this default value (see above)
 
-- `configureEntityMap(string $attribute, EntityListEntities $entities)`: configure an Entity Map to display multiple entities in a single Entity List; [see detailed section](#entity-map) above.
+- `configureEntityMap(string $attribute, EntityListEntities $entities)`: configure an Entity Map to display multiple entities in a single Entity List; [see detailed section](#entity-map) below.
 
 - `configurePageAlert(string $template, string $alertLevel = null, string $fieldKey = null, bool $declareTemplateAsPath = false)`: display a dynamic message above the list; [see detailed doc](page-alerts.md)
 
@@ -239,7 +239,7 @@ Here is the full list of available methods:
 
 - `configureQuickCreationForm(?array $fields = null)`: show the creation form in a modal instead of a full page ([see detailed doc](quick-creation-form.md))
 
-- `configureDelete(bool $hide = false, ?string $onfirmationText = null)`: the first argument is to show / hide the delete command on each instance (shown by default); this is only useful to hide the link if you want to only display the delete action in the Show Page (if you have defined one), this is NOT to be used for authorization purpose (see [dedicated documentation on this topic](entity-authorizations.md)). The second argument is the message to display in the confirmation dialog (a sensible default will be used).
+- `configureDelete(bool $hide = false, ?string $confirmationText = null)`: the first argument is to show / hide the delete command on each instance (shown by default); this is only useful to hide the link if you want to only display the delete action in the Show Page (if you have defined one), this is NOT to be used for authorization purpose (see [dedicated documentation on this topic](entity-authorizations.md)). The second argument is the message to display in the confirmation dialog (a sensible default will be used).
 
 - `configureCreateButtonLabel(string $label)` to set a custom "New..." button label.
 

docs/guide/building-form.md

@@ -4,7 +4,7 @@ sidebarDepth: 3
 
 # Create a Form
 
-Forms as used to create or update instances.
+Forms are used to create or update instances.
 
 ## Generator
 
@@ -423,7 +423,7 @@ class ProductForm extends SharpForm
 	public function buildFormConfig(): void
 	{
 		$this->configureBreadcrumbCustomLabelAttribute('name')
-			->setDisplayShowPageAfterCreation();
+			->configureDisplayShowPageAfterCreation();
 	}
 }
 ```

docs/guide/building-menu.md

@@ -41,7 +41,7 @@ class SharpServiceProvider extends SharpAppServiceProvider
 ```
 
 ::: info
-The `SharpServiceProvider` class is created bye the `sharp:install` artisan command; in case you don't have it, you can create it by yourself in the `App\Providers` namespace, or use the `sharp:make:provider` command.
+The `SharpServiceProvider` class is created by the `sharp:install` artisan command; in case you don't have it, you can create it by yourself in the `App\Providers` namespace, or use the `sharp:make:provider` command.
 :::
 
 ### Link to an Entity List, a Dashboard or to a single Show Page

docs/guide/building-show-page.md

@@ -24,7 +24,7 @@ First we build a class dedicated to our Show Page extending `Code16\Sharp\Show\S
 
 - `buildShowFields(FieldsContainer $showFields)` and `buildShowLayout(ShowLayout $showLayout)` to declare the fields presenting the instance.
 - `find($id): array` to retrieve the instance.
-- `delete($id): void` to delete the instance.
+- [optional] `delete($id): void` to delete the instance.
 - `buildShowConfig()` (optional).
 
 In detail:
@@ -262,7 +262,8 @@ class MyShow extends SharpShow
             ->setCustomTransformer(
                 'picture', 
                 new SharpUploadModelThumbnailUrlTransformer(600)
-            );
+            )
+            ->transform(Product::findOrFail($id));
     }
 }
 ```

docs/guide/commands-wizard.md

@@ -32,7 +32,7 @@ Instead of `execute()`, you must implement `executeFirstStep(array $data): array
 ```php
 class SendEmailWithPostsWizardCommand extends EntityWizardCommand
 {
-    // [...]
+    // ...
 
     public function executeFirstStep(array $data): array
     {
@@ -50,7 +50,7 @@ Wizard Commands needs forms, one for each step. To build the forms, we use the s
 ```php
 class SendEmailWithPostsWizardCommand extends EntityWizardCommand
 {
-    // [...]
+    // ...
 
     public function buildFormFieldsForFirstStep(FieldsContainer $formFields): void
     {
@@ -109,7 +109,7 @@ If your Wizard is small, this could be the right way to proceed. Simply extend t
 ```php
 class SendEmailWithPostsWizardCommand extends EntityWizardCommand
 {
-    // [...]
+    // ...
 
     protected function buildFormFieldsForStep(string $step, FieldsContainer $formFields): void
     {
@@ -133,7 +133,7 @@ This should be a better option in many cases, to clarify things in the Wizard cl
 ```php
 class SendEmailWithPostsWizardCommand extends EntityWizardCommand
 {
-    // [...]
+    // ...
 
     public function buildFormFieldsForStepComposeMessage(FieldsContainer $formFields): void
     {
@@ -200,7 +200,7 @@ Entity and Dashboard case:
 ```php
 class SendEmailWithPostsWizardCommand extends EntityWizardCommand
 {
-    // [...]
+    // ...
 
     public function executeStep(string $step, array $data = []): array
     {
@@ -277,7 +277,7 @@ Consider the following example; first we build and execute the first step; in th
 ```php
 class SendEmailWithPostsWizardCommand extends EntityWizardCommand
 {
-    // [...]
+    // ...
 
     public function buildFormFieldsForFirstStep(FieldsContainer $formFields): void
     {
@@ -303,7 +303,7 @@ For the `compose_message` step, we initialize data based on what is in the conte
 ```php
 class SendEmailWithPostsWizardCommand extends EntityWizardCommand
 {
-    // [...]
+    // ...
 
     protected function initialDataForStepComposeMessage(): array
     {
@@ -328,7 +328,7 @@ We build the form, and store a result useful for the next step in the context (a
 ```php
 class SendEmailWithPostsWizardCommand extends EntityWizardCommand
 {
-    // [...]
+    // ...
 
     public function buildFormFieldsForStepComposeMessage(FieldsContainer $formFields): void
     {