updated docs

fixes #305
fixes #309