+1 for any docs of any sort that make the code more understandable by everyone else.