improve developer notes