Improve docs (typos / spelling / language)

also add reference to the annotated source.