document final fix for Waypoint behavior in comments