Document new workflow

closes #245 and #246