Document unlinked-file diagnostic

1 files changed, 4 insertions, 0 deletions

diff --git a/crates/ide/src/diagnostics/unlinked_file.rs b/crates/ide/src/diagnostics/unlinked_file.rs
index c5741bf6b..019b0b440 100644
--- a/crates/ide/src/diagnostics/unlinked_file.rs
+++ b/crates/ide/src/diagnostics/unlinked_file.rs
@@ -20,6 +20,10 @@ use crate::Fix;
 
 use super::fixes::DiagnosticWithFix;
 
+// Diagnostic: unlinked-file
+//
+// This diagnostic is shown for files that are not included in any crate, or files that are part of
+// crates rust-analyzer failed to discover. The file will not have IDE features available.
 #[derive(Debug)]
 pub(crate) struct UnlinkedFile {
     pub(crate) file_id: FileId,