DOC minor fixes / add max-product to option strings.
Update potts model example
make page generation work with newer sphinx bootstrap
add better installation instructions