doc: document warning improvements