diff --git a/platform/drupal/README.md b/platform/drupal/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..99f4b3184ddb836ea38bb6779f95761a09bc29c6
--- /dev/null
+++ b/platform/drupal/README.md
@@ -0,0 +1,11 @@
+# provision/platform/drupal/*.inc
+
+All files in this folder are included directly into the Drupal site codebase the task is being run on.
+
+The code in these files is run fully bootstrapped to your Drupal sites.
+
+This means the code must be compatible with the Drupal version of the site.
+
+This came up as an issue when Drupal 8.4 moved to Symfony 3: The Yaml::parse() method changed, so we have to change our code to reflect that.
+
+See https://www.drupal.org/node/2911855 for more details.
\ No newline at end of file