You can add referenced in documentation (we do for a number of functions). It would also be nice to include what the function returns, any exceptions it raises, and other notes.