Documentation does not need to be DRY. Also, you should repeat yourself when it is necessary, and this is one of those cases where it is necessary. The return value must stay and all required parameters should as well