Docblock improvements

examples/2-intermediate-create-middleware.php

@@ -49,7 +49,7 @@ public function execute(Command $command, callable $next)
     }
 }
 // Some things to note:
-//     - we can execute logic before _or_ after a Command is executed by hyst
+//     - we can execute logic before _or_ after a Command is executed by
 //       changing where we call $next($command).
 //     - Tactician allows a Handler to return a value if we want, so we capture
 //       it here to return after we finish logging. This isn't required, but it

src/Middleware.php

@@ -2,9 +2,21 @@
 namespace League\Tactician;
 
 /**
+ * Middleware are the plugins of Tactician. They receive each command that's
+ * given to the CommandBus and can take any action they choose. Middleware can
+ * continue the Command processing by passing the command they receive to the
+ * $next callable, which is essentially the "next" Middleware in the chain.
  *
+ * Depending on where they invoke the $next callable, Middleware can execute
+ * their custom logic before or after the Command is handled. They can also
+ * modify, log, or replace the command they receive. The sky's the limit.
  */
 interface Middleware
 {
+    /**
+     * @param Command $command
+     * @param callable $next
+     * @return mixed
+     */
     public function execute(Command $command, callable $next);
 }