Update README.md

Author: TysonAndre

README.md

@@ -3,4 +3,28 @@ PHP-Parser to php-ast
 
 [![Build Status](https://travis-ci.org/TysonAndre/php-parser-to-php-ast.svg?branch=master)](https://travis-ci.org/TysonAndre/php-parser-to-php-ast)
 
-This is incomplete. Only 6 of 28 tests are passing.
+5 out of 28 tests are failing, and only due to line numbers being wrong in php-ast. This is fixed in php 7.1-dev (will be in 7.1.4)
+
+[Current Issues](https://github.com/TysonAndre/php-parser-to-php-ast/issues/)
+
+- The test suite this is based off of is not comprehensive, and edge cases still remain.
+  See https://github.com/TysonAndre/php-parser-to-php-ast/issues/4
+
+Usage
+-----
+
+Using it as a slow substitute for php-ast
+
+- [tests/ASTConverter/ConversionTest.php](https://github.com/TysonAndre/php-parser-to-php-ast/blob/master/tests/ASTConverter/ConversionTest.php)
+
+Using it as an error-tolerant substitute for php-ast (e.g. for use in IDEs)
+
+- There are currently two modes: omitting errors and adding placeholders (e.g. `__INCOMPLETE_VARIABLE__`).
+- Omitting errors only handles some common cases that come up while editing a file.
+- Placeholders may change in the future.
+- [tests/ASTConverter/ErrorTolerantConversionTest.php](https://github.com/TysonAndre/php-parser-to-php-ast/blob/master/tests/ASTConverter/ErrorTolerantConversionTest.php)
+
+Possible Future Enhancements
+----------------------------
+
+- https://github.com/Microsoft/tolerant-php-parser/issues/113