Comments

Author: davidwengier

src/Razor/src/Microsoft.AspNetCore.Razor.LanguageServer/ProjectSystem/RazorProjectService.cs

@@ -93,7 +93,8 @@ public Task OpenDocumentAsync(string filePath, SourceText sourceText, int versio
                 if (!_snapshotResolver.TryResolveDocumentInAnyProject(textDocumentPath, out var document))
                 {
                     // Document hasn't been added. This usually occurs when VSCode trumps all other initialization
-                    // processes and pre-initializes already open documents.
+                    // processes and pre-initializes already open documents. We add this to the misc project, and
+                    // if/when we get project info from the client, it will be migrated to a real project.
                     AddDocumentToMiscProjectCore(updater, filePath);
                 }
 

src/Razor/src/Microsoft.AspNetCore.Razor.LanguageServer/RazorFileSynchronizer.cs

@@ -17,6 +17,10 @@ internal class RazorFileSynchronizer(IRazorProjectService projectService) : IRaz
     public Task RazorFileChangedAsync(string filePath, RazorFileChangeKind kind, CancellationToken cancellationToken)
         => kind switch
         {
+            // We put the new file in the misc files project, so we don't confuse the client by sending updates for
+            // a razor file that we guess is going to be in a project, when the client might not have received that
+            // info yet. When the client does find out, it will tell us by updating the project info, and we'll
+            // migrate the file as necessary.
             RazorFileChangeKind.Added => _projectService.AddDocumentToMiscProjectAsync(filePath, cancellationToken),
             RazorFileChangeKind.Removed => _projectService.RemoveDocumentAsync(filePath, cancellationToken),
             _ => Task.CompletedTask