This contains a mix of typo and style fixes, removes some bits that were copied from APIv3 and adds or amends some sections.
Created by: totten
Agree, looks better.
