added comments relating to what the publish task needs to achieve