improving documentation a bit more