#59 javadocs for all pubSub classes