Add comment.

src/Workspaces/Core/Portable/Editing/SyntaxGenerator.cs

@@ -4,8 +4,10 @@
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
+using System.Threading;
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.Host;
+using Microsoft.CodeAnalysis.Options;
 using Microsoft.CodeAnalysis.Shared.Extensions;
 using Microsoft.CodeAnalysis.Simplification;
 using Roslyn.Utilities;
@@ -15,7 +17,14 @@ namespace Microsoft.CodeAnalysis.Editing
     /// <summary>
     /// A language agnostic factory for creating syntax nodes.
     /// 
-    /// This API can be used to create language specific syntax nodes that are semantically similar between languages.
+    /// This API can be used to create language specific syntax nodes that are semantically 
+    /// similar between languages.
+    /// 
+    /// The trees generated by this API will try to respect user preferences when
+    /// possible.  For example, generating <see cref="MemberAccessExpression(SyntaxNode, string)"/> 
+    /// will be done in a way such that "this." or "Me." will be simplified according to user
+    /// preference if any <see cref="Simplifier.ReduceAsync(Document, OptionSet, CancellationToken)" /> 
+    /// overload is called.
     /// </summary>
     public abstract class SyntaxGenerator : ILanguageService
     {