document new behaviour for collections on flush

fix #54
yeah, and refresh affects all managed documents. but i guess its just much safer to propose the refresh. ok to merge like this without adding the setInitialized?