Documentation pass: round 1