added some comments in core.clj describing my intentions