fix *executor* annotation and add note about knit