diff --git a/.azure/azure-ci-build-pipeline.yaml b/.azure/azure-ci-build-pipeline.yaml
index 239369f5..221bedd5 100644
--- a/.azure/azure-ci-build-pipeline.yaml
+++ b/.azure/azure-ci-build-pipeline.yaml
@@ -117,9 +117,12 @@ stages:
               testRunTitle: 'Publish test results'
 
           - publish: $(System.DefaultWorkingDirectory)/htmlcov/
+            # publish the html report - so we can debug the coverage if needed
+            condition: ${{ item.every_time }} # should only be run once
             artifact: coverage_report
 
           - task: PublishCodeCoverageResults@2
+            # publish the code coverage so it can be viewed in the run coverage page
             condition: ${{ item.every_time }} # should only be run once
             inputs:
               codeCoverageTool: Cobertura