document semantics of Lights

fix change of semantics made during linear migration