Edit the overview section and begin writing about PrettifyNames

Author: Exanite

docs/for-contributors/Generator/name-processing.md

@@ -13,7 +13,9 @@ Capitalization Conventions: https://learn.microsoft.com/en-us/dotnet/standard/de
 ## High-Level Overview
 
 This section explains how names flow through the SilkTouch generator pipeline.
-This section uses `vkCreateSwapchainKHR` from Vulkan as an example.
+- For more information about the pipeline itself, please see the [Generator Mods](generator-mods.md) documentation.
+
+`vkCreateSwapchainKHR` from Vulkan is used here as an example.
 
 1. Names enter the pipeline from native sources (eg: C header files).
    - Eg: `vkCreateSwapchainKHR` as input from Vulkan during the `ClangScraper` mod.
@@ -25,19 +27,28 @@ This section uses `vkCreateSwapchainKHR` from Vulkan as an example.
 
 3. `PrettifyNames` uses the metadata to transform the names according to user-provided configuration.
    - The affixes are first stripped → `CreateSwapchain`
-   - The base name is "prettified" (pascal-casing, removal of underscores) → `CreateSwapchain` (No change)
+   - The base name is "prettified" (pascal-casing, removal of underscores) → `CreateSwapchain` (No change in this case)
    - Affixes are reapplied according to user configuration → `CreateSwapchainKHR`
-      - We usually remove shared prefixes and preserve Khronos vendor suffixes.
+      - We usually remove shared prefixes and preserve Khronos vendor suffixes verbatim
+        (notably in contradiction with the Framework Design Guidelines).
+        The reasons for this are explained below.
 
-4. Unwanted metadata is stripped from the generated bindings to keep the output clean.
-   - `[NativeName]` is kept. `[NameAffix]` is removed.
+4. Mods strip most metadata from the generated bindings to keep the output clean.
+   - We generally keep metadata useful for users, while removing internal generator metadata.
+   - For example, `[NativeName]` is kept and `[NameAffix]` is removed during the `StripAttributes` mod.
    - Tip: Disabling the `StripAttributes` mod can be helpful for debugging unwanted outputs.
 
-(TODO: Elaborate more and provide examples)
-
 ## PrettifyNames
 
-(TODO: Explain how PrettifyNames is the mod central to name processing)
+As seen above, `PrettifyNames` is the mod central to name processing.
+
+The goal of this mod is to take all of the names from the generated bindings and transform them in bulk.
+This keeps other mods performant and simple, as renaming identifiers is a costly operation
+that involves searching the entire project for references to that identifier.
+Despite this, `PrettifyNames` also has the goal of remaining dumb and does this
+by relying on the generator config for all major decisions.
+
+(TODO: Explain how other mods and the user are supposed to interact with PrettifyNames)
 
 ## Name Splitting