improving documentation clarity