add some documentation around collections