better collection loading
added doc & small changes