more notes for the devs