Remove unused parseSourceInfo method in BoxEvent
Document when BoxAPIException can be thrown

Added additional information in the javadocs for classes that throw this
method. Also added a section on error handling in the overview guide.

Closes #27.