diff --git a/drupalci.yml b/drupalci.yml
index e463f9b..77ac4b3 100644
--- a/drupalci.yml
+++ b/drupalci.yml
@@ -1,3 +1,12 @@
+# This is the drupalci.yml file for the Examples project.
+
+# Learn how to make your own:
+# https://www.drupal.org/drupalorg/docs/drupal-ci/customizing-drupalci-testing-for-projects
+
+# This drupalci.yml build file should almost exactly mirror the default contrib
+# build used by the testbot. We are only adding the
+# 'suppress-deprecations: false' config to the run_tests tasks. This is so we
+# can catch Drupal core deprecations early.
 build:
   assessment:
     validate_codebase: