add doc comments to models

app/Models/Revision.php

@@ -3,10 +3,23 @@
 namespace App\Models;
 
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Collection;
 use Riesjart\Relaquent\Model\Concerns\HasRelaquentRelationships;
 
 /**
  * Table revision (a set of rows)
+ *
+ * @property int $id
+ * @property \Carbon\Carbon $created_at
+ * @property \Carbon\Carbon $updated_at
+ * @property int $refs
+ * @property int $ancestor_id
+ * @property string $note
+ * @property string $index_column
+ * @property Revision|null $parentRevision
+ * @property Row[]|Collection $rows
+ * @property Proposal|null $sourceProposal - proposal that was used to create this revision
+ * @property Proposal[]|Collection $dependentProposals
  */
 class Revision extends Model
 {
@@ -29,7 +42,7 @@ class Revision extends Model
     }
 
     /** Proposal that lead to this revision */
-    public function appliedProposal()
+    public function sourceProposal()
     {
         return $this->hasOneThrough(Proposal::class, 'revision_proposal_pivot');
     }