adding comments

explanations for the rest of the tspan approach