documentation cleanup and improvements