From 40988d2f2766893cbe78be453d677f68dc7a981a Mon Sep 17 00:00:00 2001
From: Patrick8639 <planz@ordinasoft.ch>
Date: Mon, 27 May 2024 09:52:51 +0200
Subject: [PATCH 1/2] feat(xml): better error when link not found

---
 src/Docfx.Dotnet/Parsers/XmlComment.cs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/Docfx.Dotnet/Parsers/XmlComment.cs b/src/Docfx.Dotnet/Parsers/XmlComment.cs
index 2406b90aa6f..c086e1c5c4a 100644
--- a/src/Docfx.Dotnet/Parsers/XmlComment.cs
+++ b/src/Docfx.Dotnet/Parsers/XmlComment.cs
@@ -376,7 +376,17 @@ 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("!:"))
                 {

From 8eb2136aad04f35724c4223af56b466c086f7e91 Mon Sep 17 00:00:00 2001
From: Patrick8639 <planz@ordinasoft.ch>
Date: Tue, 28 May 2024 08:27:20 +0200
Subject: [PATCH 2/2] Corrected an alignment problem.

---
 src/Docfx.Dotnet/Parsers/XmlComment.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Docfx.Dotnet/Parsers/XmlComment.cs b/src/Docfx.Dotnet/Parsers/XmlComment.cs
index c086e1c5c4a..5b55008dd96 100644
--- a/src/Docfx.Dotnet/Parsers/XmlComment.cs
+++ b/src/Docfx.Dotnet/Parsers/XmlComment.cs
@@ -384,7 +384,8 @@ private void ResolveCrefLink(XNode node, string nodeSelector, Action<string, str
                     {
                         detailedInfo.Append(", member name is ");
                         detailedInfo.Append(memberName);
-                    }                }
+                    }
+                }
 
                 Logger.Log(LogLevel.Warning, $"Invalid cref value \"{cref}\" found in XML documentation comment{detailedInfo}.", code: "InvalidCref");