I do both. All to help me in the future as much as possible when I come back scratching my head.
Terseness.
Yup. One could write "It takes a string as an argument & reverses it". Or one could write "String.reverse(()". For any non trivial case, such as weird options, you'll normally write documentation anyway.