Tweaked documentation following design review