some improvements to the doc language docs
user guide updated