add docstrings / comments to PartitionedAdder