Merge pull request #3725 from whatyouhide/mix-task-documentation-docs

Mention how to write docs for public Mix tasks

Author: josevalim

lib/mix/lib/mix/task.ex

@@ -10,7 +10,7 @@ defmodule Mix.Task do
       defmodule Mix.Tasks.Hello do
         use Mix.Task
 
-        def run(_) do
+        def run(_args) do
           Mix.shell.info "hello"
         end
       end
@@ -27,6 +27,12 @@ defmodule Mix.Task do
       on `mix help`
     * `@recursive` - run the task recursively in umbrella projects
 
+  ## Documentation
+
+  Users can read the documentation for public Mix tasks by doing `mix help
+  my_task`. The documentation that will be showed is the `@moduledoc` of the
+  task's module.
+
   """
 
   @type task_name :: String.t | atom