several improvements in writing and organization.
Merge branch '111-tutorial-draft' into develop