diff --git a/src/Endpoints/Comments.php b/src/Endpoints/Comments.php
index c25a1be..5d8d64f 100644
--- a/src/Endpoints/Comments.php
+++ b/src/Endpoints/Comments.php
@@ -38,8 +38,10 @@ public function __construct(Notion $notion)
     }
 
     /**
-     * Retrieve a list of comments
+     * Retrieve a list of comments.
+     *
      * @url https://api.notion.com/{version}/comments?block_id=* [get]
+     *
      * @reference https://developers.notion.com/reference/retrieve-a-comment.
      *
      * @param  string  $blockId
@@ -87,8 +89,10 @@ public function onPage(string $pageId): self
     }
 
     /**
-     * Create a comment
+     * Create a comment.
+     *
      * @url https://api.notion.com/{version}/comments [post]
+     *
      * @reference https://developers.notion.com/reference/create-a-comment.
      *
      * @param  CommentEntity  $comment