Updated JSdoc 

Added class properties, clean up, expose some methods that should have been documented, etc.
@ritch 
`returned-instances` is not a valid javascript identifier. `instancesList` or even `instances` would IMO work better.