added public API note
added doc notes
reduced attribute API