Document methods that return None

If a valid broker in the cluster has no partitions, it will return None rather than an empty set.

Similarly updated a few other methods.

Author: jeffwidman