add LC boilerplate
processing references to surface URLs