first stab at reorganizing and adding in new pages

based on changes decided on with nancy daneau to add pedagogical language to user guide and refer to it from the new shorter agreement.