- CI run schedules updated to not overlap.

- Updated all path specs to include all files/directories that affect builds.
- Improved documentation.

Author: paulmedynski

eng/pipelines/dotnet-sqlclient-ci-package-reference-pipeline.yml

@@ -11,12 +11,13 @@
 #   - Microsoft.Data.SqlClient
 #   - Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider
 #
-# It runs via CI push triggers and schedules:
+# It runs via CI push triggers and schedules and uses the Release build
+# configuration:
 #
 #   - Commits to GitHub main
 #   - Commits to ADO internal/main
-#   - Weekdays at 01:00 UTC on GitHub main
-#   - Thursdays at 03:00 UTC on ADO internal/main
+#   - Weekdays at 03:00 UTC on GitHub main
+#   - Thursdays at 07:00 UTC on ADO internal/main
 #
 # GOTCHA: This pipeline definition is triggered by GitHub _and_ ADO CI.  We are
 # able to define different triggers and schedules using branch filters:
@@ -45,7 +46,8 @@ name: $(DayOfYear)$(Rev:rr)
 # Trigger this pipeline on commits to certain branches.
 trigger:
 
-  # Don't trigger a new run until the previous one completes.
+  # Don't trigger a new run until the previous one completes.  This may cause
+  # multiple commits to be batched into a single run.
   batch: true
 
   branches:
@@ -60,8 +62,9 @@ trigger:
     include:
     - .azuredevops
     - .config
-    - src
+    - doc
     - eng
+    - src
     - tools
     - azurepipelines-coverage.yml
     - build.proj
@@ -72,15 +75,15 @@ schedules:
 
   # GitHub main on weekdays
   - cron: '0 3 * * Mon-Fri'
-    displayName: Weekday Release Build
+    displayName: Weekday Run (Release Config)
     branches:
       include:
       - main
     always: true
 
   # ADO internal/main on Thursdays.
-  - cron: '0 5 * * Thu'
-    displayName: Thursday Release Build
+  - cron: '0 7 * * Thu'
+    displayName: Thursday Run (Release Config)
     branches:
       include:
       - internal/main

eng/pipelines/dotnet-sqlclient-ci-project-reference-pipeline.yml

@@ -11,12 +11,13 @@
 #   - Microsoft.Data.SqlClient
 #   - Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider
 #
-# It runs via CI push triggers and schedules:
+# It runs via CI push triggers and schedules and uses the Release build
+# configuration:
 #
 #   - Commits to GitHub main
 #   - Commits to ADO internal/main
 #   - Weekdays at 01:00 UTC on GitHub main
-#   - Thursdays at 03:00 UTC on ADO internal/main
+#   - Thursdays at 05:00 UTC on ADO internal/main
 #
 # GOTCHA: This pipeline definition is triggered by GitHub _and_ ADO CI.  We are
 # able to define different triggers and schedules using branch filters:
@@ -45,7 +46,8 @@ name: $(DayOfYear)$(Rev:rr)
 # Trigger this pipeline on commits to certain branches.
 trigger:
 
-  # Don't trigger a new run until the previous one completes.
+  # Don't trigger a new run until the previous one completes.  This may cause
+  # multiple commits to be batched into a single run.
   batch: true
 
   branches:
@@ -60,8 +62,9 @@ trigger:
     include:
     - .azuredevops
     - .config
-    - src
+    - doc
     - eng
+    - src
     - tools
     - azurepipelines-coverage.yml
     - build.proj
@@ -72,15 +75,15 @@ schedules:
 
   # GitHub main on weekdays
   - cron: '0 1 * * Mon-Fri'
-    displayName: Weekday Release Build
+    displayName: Weekday Run (Release Config)
     branches:
       include:
       - main
     always: true
 
   # ADO internal/main on Thursdays.
-  - cron: '0 3 * * Thu'
-    displayName: Thursday Release Build
+  - cron: '0 5 * * Thu'
+    displayName: Thursday Run (Release Config)
     branches:
       include:
       - internal/main

eng/pipelines/sqlclient-pr-package-ref-pipeline.yml

@@ -11,7 +11,8 @@
 #   - Microsoft.Data.SqlClient
 #   - Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider
 #
-# It is triggered by pushes to PRs for dev/topic/feature branches in GitHub.
+# It is triggered by pushes to PRs that target dev/ and feature/ branches, and
+# the main branch in GitHub.
 #
 # It maps to the "PR-SqlClient-Package" pipeline in the Public project:
 #
@@ -37,8 +38,9 @@ pr:
     include:
     - .azuredevops
     - .config
-    - src
+    - doc
     - eng
+    - src
     - tools
     - azurepipelines-coverage.yml
     - build.proj

eng/pipelines/sqlclient-pr-project-ref-pipeline.yml

@@ -11,7 +11,8 @@
 #   - Microsoft.Data.SqlClient
 #   - Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider
 #
-# It is triggered by pushes to PRs for dev/topic/feature branches in GitHub.
+# It is triggered by pushes to PRs that target dev/ and feature/ branches, and
+# the main branch in GitHub.
 #
 # It maps to the "PR-SqlClient-Project" pipeline in the Public project:
 #
@@ -37,8 +38,9 @@ pr:
     include:
     - .azuredevops
     - .config
-    - src
+    - doc
     - eng
+    - src
     - tools
     - azurepipelines-coverage.yml
     - build.proj