Improve CONTRIBUTING.md

* Add sections about code and PR documentation.
* Restructure finding-an-issue section.
* All kind of style fixing