#1604: update documentation

opened by matthewkumar