I don't add inline docs except for function/api declarations. I expect contributors to read the code. I will add the inline docs for function declarations (like those you pointed out in the  comments below).