Homogenize abstract module naming and add docs

Author: nicolasstucki

compiler/src/scala/quoted/runtime/impl/QuotesImpl.scala

@@ -77,7 +77,7 @@ class QuotesImpl private (using val ctx: Context) extends Quotes, QuoteUnpickler
     }
   end extension
 
-  object reflect extends Reflection:
+  object reflect extends reflectModule:
 
     type Tree = tpd.Tree
 

library/src/scala/quoted/Quotes.scala

@@ -66,12 +66,25 @@ trait Quotes { self: runtime.QuoteUnpickler & runtime.QuoteMatching =>
     def asExprOf(using Type[X]): Expr[X]
   end extension
 
-  /** Low-level Typed AST API metaprogramming API.
-   *  This API does not have the static type guarantiees that `Expr` and `Type` provide.
+  /** Low-level Typed AST metaprogramming API.
+   *
+   *  Provides all functionality related with AST based metaprogramming.
+   *
+   *  Usage:
+   *  ```scala
+   *  def f(expr: Expr[Int])(using Quotes) =
+   *    import quotes.reflect._
+   *    val tree: Tree = Term.of(expr)
+   *    ...
+   *  ```
+   *
+   *  See `reflectModule` for full API.
+   *
+   *  @syntax markdown
    */
-  val reflect: Reflection
+  val reflect: reflectModule
 
-  /** AST reflection interface.
+  /** Low-level Typed AST metaprogramming API.
    *
    *  Provides all functionality related with AST based metaprogramming.
    *
@@ -184,7 +197,7 @@ trait Quotes { self: runtime.QuoteUnpickler & runtime.QuoteMatching =>
    *
    * @syntax markdown
    */
-  trait Reflection { self: reflect.type =>
+  trait reflectModule { self: reflect.type =>
 
     ///////////////
     //   TREES   //
@@ -3013,7 +3026,7 @@ trait Quotes { self: runtime.QuoteUnpickler & runtime.QuoteMatching =>
       *  It is the meta-programmer's responsibility to provide exactly one corresponding definition by passing
       *  this symbol to the ValDef constructor.
       *
-      *  Note: Also see Reflection.let
+      *  Note: Also see reflect.let
       *
       *  @param flags extra flags to with which the symbol should be constructed
       *  @param privateWithin the symbol within which this new method symbol should be private. May be noSymbol.
@@ -3768,7 +3781,7 @@ trait Quotes { self: runtime.QuoteUnpickler & runtime.QuoteMatching =>
     //   UTILS   //
     ///////////////
 
-    /** TASTy Reflect tree accumulator.
+    /** Customizable Tree accumulator.
     *
     *  Usage:
     *  ```
@@ -3871,7 +3884,7 @@ trait Quotes { self: runtime.QuoteUnpickler & runtime.QuoteMatching =>
     end TreeAccumulator
 
 
-    /** TASTy Reflect tree traverser.
+    /** Customizable tree traverser.
     *
     *  Usage:
     *  ```
@@ -3891,7 +3904,7 @@ trait Quotes { self: runtime.QuoteUnpickler & runtime.QuoteMatching =>
 
     end TreeTraverser
 
-    /** TASTy Reflect tree map.
+    /** Customizable tree mapper.
     *
     *  Usage:
     *  ```