doc updates for 1.0
see #22