Change Details

Closes T2784. TODO: - [X ] write doc (and update design doc) - [X] add unit tests

Closes T2784. TODO: - [X] write doc (and update design doc) - [X] add unit tests

Closes T2784. TODO: - [X ] write doc (and update design doc) - [X] add unit tests