doc/userguide

document warning system basics