updated internal dev notes