New PartitionsSpec docs.
Merge pull request #793 from metamx/partitions-docs

New PartitionsSpec docs.