work with Avi to improve documentation