add phpdocs for the BlockCollection

Author: johguentner

src/Entities/Collections/BlockCollection.php

@@ -14,12 +14,22 @@ class BlockCollection extends EntityCollection
 {
     private bool $showUnsupported = false;
 
+    /**
+     * will include unsupported blocks within your collection
+     * unsupported blocks are currently not supported by the Notion API 
+     * they will be ignored (not included) in your collection by default
+     * 
+     * @return BlockCollection
+     */
     public function withUnsupported(): BlockCollection
     {
         $this->showUnsupported = true;
         return $this;
     }
 
+    /**
+     * collects all blocks from the raw results (from notion)
+     */
     protected function collectChildren(): void
     {
         $this->collection = new Collection();
@@ -28,18 +38,29 @@ protected function collectChildren(): void
         }
     }
 
+    /**
+     * returns according blocks as collection
+     * 
+     * @return Collection
+     */
     public function asCollection(): Collection
     {
-        $collection =parent::asCollection();
+        $collection = parent::asCollection();
         if ($this->showUnsupported) {
             return $collection;
         } else {
-            return $collection->filter(function($block){
+            return $collection->filter(function ($block) {
                 return $block->getType() != 'unsupported';
             });
         }
     }
 
+    /**
+     * returns according blocks as collection and will only represent the textual content of the blocks
+     * (this is useful if you only want to work with the blocks content and not with the whole block object)
+     * 
+     * @return Collection
+     */
     public function asTextCollection(): Collection
     {
         $textCollection = new Collection();