Added shortName member, and some authoring guidance (closes #23)