Update readme

The project should have a better README.

Using markdown will improve readability, and including links to JIRA issue tracker is also good.

Future Improvments
- We should also keep adding information about how to use RESTeasy. For example a Get started section etc.
- Requirements to build. JDK version, maven version etc.
- Contrib rules, code style etc.