ticket:431 updated documentation