improved javadoc of the subscription store