docs update after review