add shorthand docs