GitBook: [master] one page modified

docs/message-types/commands.md

@@ -2,23 +2,29 @@
 
 A command is used to dispatch domain model changes. It can be accepted or rejected depending on the domain model invariants.
 
+## Communication Guide Table
+
 | Triggered by | Description |
 | :---: | :--- |
-| UI | It is NOT common practice to send commands directly from the UI. Usually the UI communicates with web APIs. |
+| UI | It is NOT common practice to send commands directly from the UI. Usually the UI communicates with web APIs |
 | API | APIs sit in the middle between UI and Server translating web requests into commands |
 | External System | It is NOT common practice to send commands directly from the External System. Usually the External System communicates with web APIs. |
 | Port | Ports are a simple way for an aggregate root to communicate with another aggregate root. |
 | Saga | Sagas are a simple way for an aggregate root to do complex communication with other aggregate roots. |
 
+## Best Practices
+
 {% hint style="success" %}
 **You can/should/must...**
 
-* a command must be immutable
-* a command must clearly state a business intent with a name in imperative form
-* a command can be rejected due to domain validation, error or other reason
-* a command must update only one AggregateRoot
+* a command **must** be immutable
+* a command **must** clearly state a business intent with a name in imperative form
+* a command **can** be rejected due to domain validation, error or other reason
+* a command **must** update only one AggregateRoot
 {% endhint %}
 
+## Examples
+
 ```csharp
 public class DeactivateAccount : ICommand
 {