document new behaviour for collections on flush

fix #54
this is not related to the collection handling, just stumbled over it.