Document changed_when clause

Documentation update related to #3524