#7: add doc on run operation