Improves help text

Author: c4milo

README.md

@@ -5,16 +5,22 @@ Yet another Github release command line tool. This one, though, is much more min
 ```
 Github command line release tool.
 Usage:
-	gh-release <user/repo> <tag> <branch> <description> <files>
-
-	<files> can be specified using glob patterns.
+  github-release <user/repo> <tag> <branch> <description> <files>
 
+Parameters:
+  <user/repo>: Github user and repository
+  <tag>: Used to created the release. It is also used as the release's name
+  <branch>: Reference from where to create the provided <tag>, if it does not exist
+  <description>: The release description
+  <files>: Glob pattern describing the list of files to include in the release
 Options:
-	-version: Displays version
-```
+  -version: Displays version
 
-### Requirements
-Make sure you have a Github token with the correct authorization scope to allow you to create releases. For more information about creating tokens please read https://help.github.com/articles/creating-an-access-token-for-command-line-use/
+Before using this tool make sure you set the environment variable GITHUB_TOKEN
+with a valid Github token and correct authorization scopes to allow you to create releases
+in your project. For more information about creating Github tokens please read the
+official Github documentation at https://help.github.com/articles/creating-an-access-token-for-command-line-use/
+```
 
 ### Examples
 Feel free to inspect this project's [Makefile](https://github.com/c4milo/github-release/blob/master/Makefile) for an example on how this tool can be used to create releases like this:

main.go

@@ -71,7 +71,8 @@ Options:
 
 Before using this tool make sure you set the environment variable GITHUB_TOKEN
 with a valid Github token and correct authorization scopes to allow you to create releases
-in your project.
+in your project. For more information about creating Github tokens please read the 
+official Github documentation at https://help.github.com/articles/creating-an-access-token-for-command-line-use/
 
 `