Update README file

Link directly to the pdf of the documentation
Update the section on how to run the unit-tests
Add some debugging information
Ignore the vim swap files