added notes into docs