.

Author: SimonCropp

docs/mdsource/text-file-settings.include.md

@@ -14,6 +14,8 @@ All text extensions of `*.verified.*` should have:
  * `eol` set to `lf`
  * `working-tree-encoding` set to `UTF-8`
 
+Note: `working-tree-encoding=UTF-8` is correct even though Verify writes files with a BOM. Git doesn't strip or add the BOM — it just passes through transparently. The `UTF-8-BOM` encoding would explicitly add a BOM on checkout and strip it on commit (so the internal blob differs from the working tree), but that's not the desired behavior since Verify writes the BOM itself and it should be preserved in the blob too.
+
 All Binary files should also be marked to avoid merging and line ending issues with binary files.
 
 eg add the following to `.gitattributes`