major documentation improvement