Documentation updates

Updated for potential adoption of mark2