more additions to authoring docs