[docs] split out developer notes