This talk at pyTexas is really good for laying out specific Questions to ask yourself that can guide you to better docs: http://www.pyvideo.org/video/3167/keynote-developer-experien...