Added javadoc

Hopefully that's a good start... 
Maybe I should just add this as "being open for debate" still in the javadoc, wdyt?