revise ukm docs
document "puppet mode"