adding some notes into the docs