Refactoring

README.md

@@ -176,20 +176,21 @@ $tree = User::tree(3)->get();
 $tree = User::treeOf($constraint, 3)->get();
 ```
 
-You can also chaperone tree relations to load parent/ancestor relations already present in the tree to (potentially) reduce 1+n queries:
+You can also chaperone tree relationships to load `ancestors` and `parent` relationships already present in the tree to
+(potentially) reduce N+1 queries:
 
 ```php
-$tree = User::tree(3)->get();
+$users = User::tree(3)->get();
 
-$tree->loadTreePathRelations();
+$users->loadTreeRelationships();
 ```
 
-Or via `toTree`:
+Or with `toTree()`:
 
 ```php
 $users = User::tree(1)->get();
 
-$tree = $users->loadTreePathRelations()->toTree();
+$tree = $users->loadTreeRelationships()->toTree();
 ```
 
 #### Filters

src/Eloquent/Collection.php

@@ -52,11 +52,11 @@ public function toTree($childrenRelation = 'children')
     }
 
     /**
-     * Load parent/ancestor relations already present in the tree.
+     * Load ancestor and parent relationships already present in the tree.
      *
      * @return static
      */
-    public function loadTreePathRelations(): static
+    public function loadTreeRelationships(): static
     {
         if ($this->isEmpty()) {
             return $this;

tests/Tree/CollectionTest.php

@@ -40,11 +40,11 @@ public function testToTreeWithEmptyCollection(): void
         $this->assertEmpty($tree);
     }
 
-    public function testLoadTreePathRelations(): void
+    public function testLoadTreeRelationships(): void
     {
         DB::enableQueryLog();
 
-        $users = User::tree()->get()->loadTreePathRelations();
+        $users = User::tree()->get()->loadTreeRelationships();
 
         $this->assertCount(1, DB::getQueryLog());
 
@@ -59,11 +59,11 @@ public function testLoadTreePathRelations(): void
         }
     }
 
-    public function testLoadTreePathRelationsWithMissingModels(): void
+    public function testLoadTreeRelationshipsWithMissingModels(): void
     {
         DB::enableQueryLog();
 
-        $users = User::tree()->where('id', '>', 5)->get()->loadTreePathRelations();
+        $users = User::tree()->where('id', '>', 5)->get()->loadTreeRelationships();
 
         $this->assertCount(2, DB::getQueryLog());
 
@@ -78,9 +78,9 @@ public function testLoadTreePathRelationsWithMissingModels(): void
         }
     }
 
-    public function testLoadTreePathRelationsWithEmptyCollection(): void
+    public function testLoadTreeRelationshipsWithEmptyCollection(): void
     {
-        $users = User::tree(1)->where('id', 0)->get()->loadTreePathRelations();
+        $users = User::tree(1)->where('id', 0)->get()->loadTreeRelationships();
 
         $this->assertEmpty($users);
     }