Improve README

1 files changed, 17 insertions, 4 deletions

diff --git a/README.md b/README.md
index fe0d339..e4b87ee 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@ zsh-completions
 
 **Additional completion definitions for [Zsh](http://www.zsh.org).**
 
-The scripts are meant to be contributed to the Zsh project when stable enough.
+*This projects aims at gathering/developing new completion scripts that are not available in Zsh yet. The scripts are meant to be contributed to the Zsh project when stable enough.*
 
 
 Status
@@ -13,10 +13,23 @@ See [issues](zsh-completions/issues) for details on each completion definition.
 
 Usage
 -----
-Drop the scripts in a directory included in your `$fpath`, for example:
+* Clone the repository:
 
-    git clone git://github.com/zsh-users/zsh-completions.git
-    fpath=(path/to/zsh-completions $fpath)
+        git clone git://github.com/zsh-users/zsh-completions.git
+
+* Include the directory in your `$fpath`, for example:
+
+        fpath=(path/to/zsh-completions $fpath)
+
+
+Contributing
+------------
+
+Contributions are welcome, just make sure you follow the guidelines:
+
+ * Please add a header containing authors, license info, status and origin of the script (example [here](https://github.com/zsh-users/zsh-completions/blob/master/_ack)).
+ * Please try to follow [Zsh completion style guide](https://github.com/zsh-users/zsh/blob/master/Etc/completion-style-guide).
+ * Send a pull request or ask for committer access.
 
 
 License