changelog/docs for #332