Fixed up the docs a bit with sugesstions from Kenton