fix some typos in docs, add brief section on annotation cache
wording tweaks
Merge pull request #51 from tomverran/develop

Small documentation tweaks