Helpful implicit not found message for quotes.Quotes

Fixes #16888

Author: nicolasstucki

library/src/scala/quoted/Quotes.scala

@@ -1,6 +1,7 @@
 package scala.quoted
 
 import scala.annotation.experimental
+import scala.annotation.implicitNotFound
 import scala.reflect.TypeTest
 
 /** Current Quotes in scope
@@ -21,7 +22,23 @@ transparent inline def quotes(using q: Quotes): q.type = q
  *
  *  It contains the low-level Typed AST API metaprogramming API.
  *  This API does not have the static type guarantees that `Expr` and `Type` provide.
+ *
+ *  `Quotes` are generated from an enclosing `${ ... }` or `scala.staging.run`. For example:
+ *  ```scala
+ *  import scala.quoted._
+ *  inline def myMacro: Expr[T] =
+ *    ${ /* (quotes: Quotes) ?=> */ myExpr }
+ *  def myExpr(using Quotes): Expr[T] =
+ *    '{ f(${ /* (quotes: Quotes) ?=> */ myOtherExpr }) }
+ *  }
+ *  def myOtherExpr(using Quotes): Expr[U] = '{ ... }
+ *  ```
  */
+@implicitNotFound("""No given instance of type scala.quoted.Quotes was found.
+
+Quotes are generated from an enclosing splice `$ { ... }` or `scala.staging.run` call.
+Maybe that splice `$ { ... }` or `scala.staging.run` is missing?
+""")
 trait Quotes { self: runtime.QuoteUnpickler & runtime.QuoteMatching =>
 
   // Extension methods for `Expr[T]`

tests/neg-macros/i16888.check

@@ -0,0 +1,7 @@
+-- [E172] Type Error: tests/neg-macros/i16888.scala:1:38 ---------------------------------------------------------------
+1 |def test = summon[scala.quoted.Quotes] // error
+  |                                      ^
+  |                            No given instance of type scala.quoted.Quotes was found.
+  |
+  |                            Quotes are generated from an enclosing splice `$ { ... }` or `scala.staging.run` call.
+  |                            Maybe that splice `$ { ... }` or `scala.staging.run` is missing?

tests/neg-macros/i16888.scala

@@ -0,0 +1 @@
+def test = summon[scala.quoted.Quotes] // error

tests/neg-macros/i6436.check

@@ -1,7 +1,10 @@
 -- [E172] Type Error: tests/neg-macros/i6436.scala:5:9 -----------------------------------------------------------------
 5 |    case '{ StringContext(${Varargs(parts)}*) } => // error
   |         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-  |         No given instance of type scala.quoted.Quotes was found
+  |         No given instance of type scala.quoted.Quotes was found.
+  |
+  |         Quotes are generated from an enclosing splice `$ { ... }` or `scala.staging.run` call.
+  |         Maybe that splice `$ { ... }` or `scala.staging.run` is missing?
 -- [E006] Not Found Error: tests/neg-macros/i6436.scala:6:34 -----------------------------------------------------------
 6 |      val ps: Seq[Expr[String]] = parts // error
   |                                  ^^^^^