[commands] Better note for Command.invoke

discord/ext/commands/context.py

@@ -94,13 +94,18 @@ class Context(discord.abc.Messageable):
         This is useful if you want to just call the callback that a
         :class:`.Command` holds internally.
 
-        Note
-        ------
-        You do not pass in the context as it is done for you.
+        .. note::
+
+            This does not handle converters, checks, cooldowns, pre-invoke,
+            or after-invoke hooks in any matter. It calls the internal callback
+            directly as-if it was a regular function.
+
+            You must take care in passing the proper arguments when
+            using this function.
+
+        .. warning::
 
-        Warning
-        ---------
-        The first parameter passed **must** be the command being invoked.
+            The first parameter passed **must** be the command being invoked.
 
         Parameters
         -----------