[docs] Cleanup list of linters in contributors guide

[cidrblock]

trafficstars

We can add links, and improve the descriptions, and fix formatting

Also-

for things like pylint, we should explain the exceptions should be inline not global for mypy, we should explain the actual error code should be used if a type ignore is added

Related: #692