update DOCS to highlight emphasis on maintaining BC while clearly outlining where BC has been broken. refs #1002, #1261
add information about routes in javascript
correct bold formatting
move removed events to deprecated area of docs
Merge pull request #1853 from craigh/docUpdate

Doc update