doc and fixes for result