document changes related to the cluster and union layer