improving Beach docs, closes #733