add additional commentary about warnings