From 798e748615ea3458c1c1529741a73d1bfc0558dc Mon Sep 17 00:00:00 2001
From: Patrick Lanz <planz@ordinasoft.ch>
Date: Wed, 29 May 2024 10:16:22 +0200
Subject: [PATCH] feat(xml): better error when link not found (#9957)

* feat(xml): better error when link not found

* Corrected an alignment problem.

---------

Co-authored-by: Yufei Huang <yufeih@live.com>
---
 src/Docfx.Dotnet/Parsers/XmlComment.cs | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/src/Docfx.Dotnet/Parsers/XmlComment.cs b/src/Docfx.Dotnet/Parsers/XmlComment.cs
index 2406b90aa6f..5b55008dd96 100644
--- a/src/Docfx.Dotnet/Parsers/XmlComment.cs
+++ b/src/Docfx.Dotnet/Parsers/XmlComment.cs
@@ -376,7 +376,18 @@ private void ResolveCrefLink(XNode node, string nodeSelector, Action<string, str
                     }
                 }
 
-                Logger.Log(LogLevel.Warning, $"Invalid cref value \"{cref}\" found in XML documentation comment {detailedInfo}.", code: "InvalidCref");
+                if (detailedInfo.Length == 0 && node is XDocument doc)
+                {
+                    var memberName = (string) doc.Element("member")?.Attribute("name");
+
+                    if (! string.IsNullOrEmpty(memberName))
+                    {
+                        detailedInfo.Append(", member name is ");
+                        detailedInfo.Append(memberName);
+                    }
+                }
+
+                Logger.Log(LogLevel.Warning, $"Invalid cref value \"{cref}\" found in XML documentation comment{detailedInfo}.", code: "InvalidCref");
 
                 if (cref.StartsWith("!:"))
                 {