Updated documentation on raven timeout issues
Updated references to README
Minor renaming and formatting changes