renamed partition() -> partitioned(), primary() -> clustered() as appropriate
updated/added javadocs