diff --git a/ICSharpCode.ILSpyX/MermaidDiagrammer/ClassDiagrammerFactory.cs b/ICSharpCode.ILSpyX/MermaidDiagrammer/ClassDiagrammerFactory.cs
index a726883e29..7eedf77f6c 100644
--- a/ICSharpCode.ILSpyX/MermaidDiagrammer/ClassDiagrammerFactory.cs
+++ b/ICSharpCode.ILSpyX/MermaidDiagrammer/ClassDiagrammerFactory.cs
@@ -47,6 +47,7 @@ public ClassDiagrammerFactory(XmlDocumentationFormatter? xmlDocs)
 		{
 			this.xmlDocs = xmlDocs;
 
+			//TODO not sure LanguageVersion.Latest is the wisest choice here; maybe cap this for better mermaid compatibility?
 			decompilerSettings = new DecompilerSettings(Decompiler.CSharp.LanguageVersion.Latest) {
 				AutomaticProperties = true // for IsHidden to return true for backing fields
 			};
diff --git a/ICSharpCode.ILSpyX/MermaidDiagrammer/html/script.js b/ICSharpCode.ILSpyX/MermaidDiagrammer/html/script.js
index 824d5d221c..f26c851b32 100644
--- a/ICSharpCode.ILSpyX/MermaidDiagrammer/html/script.js
+++ b/ICSharpCode.ILSpyX/MermaidDiagrammer/html/script.js
@@ -321,6 +321,8 @@
                         }
                     },
 
+                    /*  TODO watch https://github.com/mermaid-js/mermaid/issues/6034 for a solution to render multiple self-references,
+                        which is currently broken. E.g. for LightJson.JsonValue (compare console log) */
                     // renders HasOne and HasMany relations
                     renderRelations = (typeId, relations, many) => {
                         if (relations) // expecting object; only process if not null or undefined