fix some typos in docs, add brief section on annotation cache