update documentation to better detail the use of the display