hopefully final documentation cleanup exercise