added better (public) reference link in function comments