doc: Improve contributors guide

* Add details on expectations of docstrings.
* State pylint expectations (or lack of).
* Cleanup the self test section.
* Add section on how to update binary tools.