Update the description of the project
Update details on protocol/raven/sentry versions
Create a README for the main raven module
Fix code colouring
Add info on an implementation of slf4j
Use the same class name as in the later examples
Use HTTPS links when possible
Set the log level to ALL (just in case)
Fix links to use HTTPS
Do not overuse the code blocks and link to projects rather than files