add shortform into doc for easy copy/pasting