diff --git a/src/wp-includes/comment-template.php b/src/wp-includes/comment-template.php
index 2ed2a32cd3..72f7291e1d 100644
--- a/src/wp-includes/comment-template.php
+++ b/src/wp-includes/comment-template.php
@@ -295,6 +295,10 @@ function comment_author_IP( $comment_ID = 0 ) { // phpcs:ignore WordPress.Naming
 
 /**
  * Retrieve the url of the author of the current comment.
+ * 
+ * Returns the comment author's URL (usually their web site), not linked. This tag must be within The Loop, or a comment loop.
+ * 
+ * If the author provided no URL, this will return an empty string.
  *
  * @since 1.5.0
  * @since 4.4.0 Added the ability for `$comment_ID` to also accept a WP_Comment object.