Fix the before/after invoke docs

Author: EvieePy

twitchio/ext/commands/bot.py

@@ -452,7 +452,7 @@ async def after_invoke(self, ctx: Context) -> None:
         Commands from :class:`~.commands.Component`'s are included, however if you wish to control them separately,
         see: :meth:`~.commands.Component.component_after_invoke`.
 
-        The post-invoke hook will be called after a valid command has been invoked. If this coroutine errors,
+        The post-invoke hook will be called after a valid command has completed invocation. If this coroutine errors,
         a :exc:`~.commands.CommandHookError` will be raised from the original error.
 
         Useful for cleaning up any state like database connections or http clients.

twitchio/ext/commands/core.py

@@ -621,9 +621,11 @@ def error(self, func: Any) -> Any:
     def before_invoke(self, func: Any) -> Any:
         """|deco|
 
-        A decorator which adds a local ``before_invoke`` callback to this command.
+        A decorator which adds a local ``before_invoke`` callback to this command, similar to
+        :meth:`~twitchio.ext.commands.Bot.before_invoke` except local to this command.
 
-        Similar to :meth:`~twitchio.ext.commands.Bot.before_invoke` except local to this command.
+        The ``before_invoke`` hook is called before the command callback, but after parsing arguments and guards are
+        successfully completed. Could be used to setup state for the command for example.
 
         Example
         -------
@@ -659,9 +661,17 @@ async def test_after(ctx: commands.Context) -> None:
     def after_invoke(self, func: Any) -> Any:
         """|deco|
 
-        A decorator which adds a local ``after_invoke`` callback to this command.
+        A decorator which adds a local ``after_invoke`` callback to this command, similar to
+        :meth:`~twitchio.ext.commands.Bot.after_invoke` except local to this command.
+
+        The ``after_invoke`` hook is called after the command callback has completed invocation. Could be used to cleanup
+        state after command invocation.
+
+        .. note::
+
+            This hook is always called; even when the :class:`~.commands.Command` fails to invoke. However, similar to
+            :meth:`.before_invoke` only if parsing arguments and guards are successfully completed.
 
-        Similar to :meth:`~twitchio.ext.commands.Bot.after_invoke` except local to this command.
 
         Example
         -------