HH-43583 add an example and update docs