document helper function
changelog