Added javadoc

Hopefully that's a good start... 
"transient resources"?