diff --git a/dotty/diagrams/src/main/scala/org/scalatest/diagrams/DiagrammedExpr.scala b/dotty/diagrams/src/main/scala/org/scalatest/diagrams/DiagrammedExpr.scala
index 7c2824a23b..2a0e812118 100644
--- a/dotty/diagrams/src/main/scala/org/scalatest/diagrams/DiagrammedExpr.scala
+++ b/dotty/diagrams/src/main/scala/org/scalatest/diagrams/DiagrammedExpr.scala
@@ -59,6 +59,14 @@ object DiagrammedExpr {
    */
   def simpleExpr[T](expression: T, anchor: Int): DiagrammedExpr[T] = new DiagrammedSimpleExpr(expression, anchor)
 
+  /**
+   * Create by-name <code>DiagrammedExpr</code> that wraps <code>by-name</code> or <code>Function</code> expression.
+   * The created <code>DiagrammedExpr</code> will not be displayed in the diagram as value.
+   *
+   * @param expression the by-name expression value
+   * @param anchor the anchor of the expression
+   * @return a by-name <code>DiagrammedExpr</code>
+   */
   def byNameExpr[T](expression: => T, anchor: Int): DiagrammedExpr[T] = new DiagrammedByNameExpr(expression, anchor)
 
   /**
diff --git a/jvm/diagrams/src/main/scala/org/scalatest/diagrams/DiagrammedExpr.scala b/jvm/diagrams/src/main/scala/org/scalatest/diagrams/DiagrammedExpr.scala
index dd5f13f9c5..cf0f981295 100644
--- a/jvm/diagrams/src/main/scala/org/scalatest/diagrams/DiagrammedExpr.scala
+++ b/jvm/diagrams/src/main/scala/org/scalatest/diagrams/DiagrammedExpr.scala
@@ -59,6 +59,14 @@ object DiagrammedExpr {
    */
   def simpleExpr[T](expression: T, anchor: Int): DiagrammedExpr[T] = new DiagrammedSimpleExpr(expression, anchor)
 
+  /**
+   * Create by-name <code>DiagrammedExpr</code> that wraps <code>by-name</code> or <code>Function</code> expression.
+   * The created <code>DiagrammedExpr</code> will not be displayed in the diagram as value.
+   *
+   * @param expression the by-name expression value
+   * @param anchor the anchor of the expression
+   * @return a by-name <code>DiagrammedExpr</code>
+   */
   def byNameExpr[T](expression: => T, anchor: Int): DiagrammedExpr[() => T] = new DiagrammedByNameExpr(() => expression, anchor)
 
   /**