add comments to workflow doc