add code commentary for those that view-source
update for new provisor API