docs

Author: SimonCropp

docs/mdsource/verify-directory.source.md

@@ -23,4 +23,15 @@ snippet: VerifyDirectoryWithInfoXunitV3
 
 snippet: VerifyDirectoryWithFileScrubberXunitV3
 
-This applies to files where the extensions is a known text file as defined by [FileExtensions.IsText](https://github.com/VerifyTests/EmptyFiles#istext).
+This applies to files where the extensions is a known text file as defined by [FileExtensions.IsText](https://github.com/VerifyTests/EmptyFiles#istext).
+
+
+## Files with no extension
+
+Any files in the target directory that have no extension will have `.noextension` added to the resulting `.verified` file. This is to avoid `.verified` being treated as the extension of that file.
+
+These files are treated as unknown binaries by default. Given the lack of an extension, no diff tool will be launched.
+
+Files with no extension can optionally be treated as text, with the associated diff tool being launched. This is done by using the [AddTextFileConvention](https://github.com/VerifyTests/EmptyFiles?tab=readme-ov-file#addtextfileconvention) of EmptyFiles:
+
+snippet: AddTextFileConvention

docs/verify-directory.md

@@ -81,3 +81,27 @@ public Task VerifyDirectoryWithFileScrubber() =>
 <!-- endSnippet -->
 
 This applies to files where the extensions is a known text file as defined by [FileExtensions.IsText](https://github.com/VerifyTests/EmptyFiles#istext).
+
+
+## Files with no extension
+
+Any files in the target directory that have no extension will have `.noextension` added to the resulting `.verified` file. This is to avoid `.verified` being treated as the extension of that file.
+
+These files are treated as unknown binaries by default. Given the lack of an extension, no diff tool will be launched.
+
+Files with no extension can optionally be treated as text, with the associated diff tool being launched. This is done by using the [AddTextFileConvention](https://github.com/VerifyTests/EmptyFiles?tab=readme-ov-file#addtextfileconvention) of EmptyFiles:
+
+<!-- snippet: AddTextFileConvention -->
+<a id='snippet-AddTextFileConvention'></a>
+```cs
+[ModuleInitializer]
+public static void InitTextFileConvention() =>
+    FileExtensions.AddTextFileConvention(
+        path =>
+        {
+            var name = Path.GetFileName(path);
+            return name.Equals("TextDocWithoutExtension", StringComparison.OrdinalIgnoreCase);
+        });
+```
+<sup><a href='/src/Verify.Tests/VerifyDirectoryTests.cs#L6-L15' title='Snippet source file'>snippet source</a> | <a href='#snippet-AddTextFileConvention' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->