module rename partitions -> partition_scheme, with a few docstring fixes