changelog/docs for #521, fix #402