update docs and tweak message on front page