add a note to bridge to real world terminology