add convenience for using with a form, add some docs