improving code comments in linkify method