improving documentation
after merging