docs and changelog for #526