Added some notes and exposed the makeLink method for subclasses.