update some comments
triggers need to be a list or None
add notes on 1000+ jobs