Make warning messages more presentable

Author: abgruszecki

scala3doc/src/dotty/dokka/tasty/comments/BaseConverter.scala

@@ -10,9 +10,10 @@ trait BaseConverter {
   protected def withParsedQuery(queryStr: String)(thunk: Query => dkkd.DocTag): dkkd.DocTag = {
     QueryParser(queryStr).tryReadQuery() match {
       case Left(err) =>
+        val msg = err.getMessage
         // TODO: for better experience we should show source location here
-        println("WARN: " + err.getMessage)
-        dkkd.A(List(dkk.text(err.getMessage)).asJava, Map("href" -> "#").asJava)
+        println("WARN: " + msg)
+        dkkd.A(List(dkk.text(queryStr)).asJava, Map("href" -> "#").asJava)
       case Right(query) =>
         thunk(query)
     }

scala3doc/src/dotty/dokka/tasty/comments/MarkdownConverter.scala

@@ -161,17 +161,8 @@ class MarkdownConverter(val repr: Repr) extends BaseConverter {
     case _: mda.SoftLineBreak => emit(dkkd.Br.INSTANCE)
 
     case _ =>
-      println(s"!!! DEFAULTING @ ${n.getNodeName}")
-      emit(dkkd.P(
-        List[dkkd.DocTag](
-          dkkd.Span(
-            List(dkk.text(s"!!! DEFAULTING @ ${n.getNodeName}")).asJava,
-            kt.emptyMap,
-          ),
-          dkk.text(MarkdownParser.renderToText(n))
-        ).asJava,
-        kt.emptyMap[String, String]
-      ))
+      println(s"WARN: Encountered unrecognised Markdown node `${n.getNodeName}`, please open an issue.")
+      emit(dkk.text(MarkdownParser.renderToText(n)))
   }
 
   def extractAndConvertSummary(doc: mdu.Document): Option[dkkd.DocTag] =
@@ -189,6 +180,7 @@ class MarkdownConverter(val repr: Repr) extends BaseConverter {
         case Some((sym, targetText)) =>
           dkkd.DocumentationLink(sym.dri, resolveBody(default = targetText), kt.emptyMap)
         case None =>
+          println(s"WARN: Definition lookup for following query failed: $queryStr")
           dkkd.A(resolveBody(default = query.join), Map("href" -> "#").asJava)
       }
     }