comments on part coefficient

Lots of comments and documentation on partition coefficient work.