docs for short names