re #33 - finalizing text for v.1.0