added a few notes relevant to devs