fixed some typos, tweaked the docs a bit