make references more readable
given warnings a reason to exist