updated comments on use of for vs. map/flatmap etc.