Documentation review + add contrib guidelines, close #2000, close #2001