Minor documentation update:

- resolve some internal language inconsistencies
- correct a few minor errors
- document the 'ready' event
- use relative links, when possible, to avoid branch reference issues