update python doc index to fix typo + clarify some common questions

refs #204