Added javadoc

Hopefully that's a good start... 
It'll be a Store.Iterator anyways... Or do you say we should extract to a top level class?
I am not quite sure how I feel about all these inner types we have so far btw..