examples updated by comments