remove large comment blocks, add some new comments to explain areas
clean up list controller
fix closed class usage