alekssamos rewrite doc and fix small errors