some more doc notes