doc: added explanation for differences in examples