Restrict feature set of AddReferencedNameAffix even more for simplicity

Author: Exanite

sources/SilkTouch/SilkTouch/Naming/NameAffixer.cs

@@ -158,10 +158,13 @@ public static SyntaxList<AttributeListSyntax> AddNameAffix(
     /// <remarks>
     /// This allows compound names to be handled more cleanly.
     /// <para/>
-    /// For simplicity, only names within the same scope depth are currently supported.
-    /// This should cover most real world use cases since
-    /// if something is nested and has the parent name as a prefix,
-    /// then the prefix is likely unnecessary.
+    /// For simplicity, only names within the same name container are currently supported.
+    /// This lets us skip sorting across different containers.
+    /// This should cover most real world use cases since if something is nested and
+    /// has the parent name as a prefix, then the prefix is likely unnecessary.
+    /// <para/>
+    /// Similarly, only direct references are supported. Transitive references are not.
+    /// This lets us naively sort all references to the end of the container without a topological sort.
     /// </remarks>
     /// <example>
     /// For example, <c>PerformanceCounterDescriptionARM</c> can be used as a referenced prefix for <c>PerformanceCounterDescriptionARMName</c>.