Fix typo and add comments about code paths

While @ptony82 was giving his talk, I noticed a typo and @renatof noted that some more comments would be nice here.