added doc notes