some improvements in the Documenting Aggregate Additions section