Package documentation refinements

Despite that we have a complete Wiki on Github, it's essential to improve standard godoc package description that many users are used to read while development.