Add docs for new warning format and using it effectively