It may be better to move this from a docstring to a comment. Also, no need to have this note twice.