Update README.md

Author: dunglas

README.md

@@ -1,13 +1,22 @@
 # PHPDoc to Type Hint
 
+`phpdoc-to-typehint` adds automatically scalar type hints and return types to all functions and methods of a PHP project
+using existing PHPDoc annotations.
+
 [![Build Status](https://travis-ci.org/dunglas/phpdoc-to-typehint.svg?branch=master)](https://travis-ci.org/dunglas/phpdoc-to-typehint)
 [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/dunglas/phpdoc-to-typehint/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/dunglas/phpdoc-to-typehint/?branch=master)
 
-Add automatically scalar type hints and return types to all functions and methods of a PHP project using existing
-PHPDoc annotations.
+**Warning**: this project is an early stage of development. It **can** damage your code.
+Be sure to make a backup before running this command and to run your test suite after.
+
+Please [report](https://github.com/dunglas/phpdoc-to-typehint/issues) any bug you find using this tool.
+
+## Install and usage
+
+1. [Download the latest PHAR file](https://github.com/dunglas/phpdoc-to-typehint/releases)
+2. Run `php phpdoc-to-typehint.phar <your-project-directory>
 
-**Warning**: this project is an early stage and is experimental. It **can** damage your code.
-Be sure to make a backup before running this command and to run all your test suites after.
+You're project should have scalar type hints and return type declarations.
 
 ## Credits