DOC/STY: fixed some sphinx issues and other suggestions based on comments from @ebolyen