tweaks to notes for greater api consistency