Merge "Clarify documentation for the dimming stage." into tm-dev