Write the TransformEnums section and add note about ClangScraper platform differences

Author: Exanite

docs/for-contributors/Generator/generator-mods.md

@@ -146,6 +146,12 @@ This is a critical mod used to generate the initial set of raw C# bindings for C
 to using `ClangSharpPInvokeGenerator`. The C# source code generated by this mod is typically the starting point for all
 of the transformations done by the rest of the SilkTouch mods.
 
+Note that this mod is platform specific and will have different outputs depending on the platform. This is because
+`ClangScraper` makes use of system headers. Any platform specific differences in the API for which bindings are being
+generated will also affect the output.
+
+(TODO: Document platform specific differences and how they are handled by Silk)
+
 Usage recommendations:
 
 This mod is configured differently from the rest of the mods. The JSON mod configuration follows the same pattern as the
@@ -545,8 +551,28 @@ attributes can also be helpful for this or other purposes.
 
 Mod categories: Transformation
 
+This mod focuses on the transformation of enum types.
+
 Usage recommendations:
 
+This mod can be used to reduce the platform specific differences in the generated bindings. For example, enums use
+signed backing types by default on Windows while enums default to unsigned backing types on Unix. This is controlled by
+the `CoerceBackingTypes` configuration option.
+
+This mod can also be used to transform `[Flags]` enums in various ways. A `None = 0` member can be added for `[Flags]`
+enums that do not have an equivalent. Member values can also be rewritten to use hexadecimal for `[Flags]` enums and
+decimal values for normal enums.
+
+Finally, the last feature is that member can be according to a filter. This filter can filter the type name and the
+member name by regex. The filter can also filter by member value. One common use case is for removing the "max value"
+enum members used by native libraries to ensure that enum backing types are a specific width. For example, in Vulkan,
+the value used is `0x7FFFFFFF`, equivalent to the maximum value of a 32-bit signed integer.
+
+Note: Currently, `TransformEnums` requires the `[Flags]` attribute on enum types to be added by another mod.
+`TransformEnums` does not yet have the functionality to identify enums on its own. This is a relatively high priority
+task. However, also note that identification will be done using a heuristic and may not be perfectly accurate. If other
+metadata is available for identifying `[Flags]` enums, consider using that instead for better results.
+
 ### TransformFunctions
 
 Mod categories: Transformation