update notes about functions