Adding documentation comments

app/Models/ApplicationForm.php

@@ -119,6 +119,9 @@ public function user(): \Illuminate\Database\Eloquent\Relations\BelongsTo
         return $this->belongsTo('App\Models\User')->withoutGlobalScope('verified');
     }
 
+    /**
+     * Lists the files belonging to the application form.
+     */
     public function files(): \Illuminate\Database\Eloquent\Relations\HasMany
     {
         return $this->hasMany('App\Models\File');

app/Models/Workshop.php

@@ -61,25 +61,37 @@ class Workshop extends Model
         self::TORTENESZ,
     ];
 
+    /**
+     * Lists all members of the workshop.
+     */
     public function users()
     {
         return $this->belongsToMany(User::class, 'workshop_users');
     }
 
+    /**
+     * Lists the workshop's residents.
+     */
     public function residents()
     {
         return $this->users->filter(function ($user, $key) {
             return $user->isResident();
         });
     }
 
+    /**
+     * Lists the workshop's resident-externs.
+     */
     public function residentExterns()
     {
         return $this->users->filter(function ($user, $key) {
             return $user->isResidentExtern();
         });
     }
 
+    /**
+     * Lists the workshop's externs.
+     */
     public function externs()
     {
         return $this->users->filter(function ($user, $key) {
@@ -104,6 +116,9 @@ public function balance(int $semester = null): ?WorkshopBalance
         return $this->balances()->firstWhere('semester_id', $semester ?? Semester::current()->id);
     }
 
+    /**
+     * Returns the color of the workshop's badge to be displayed.
+     */
     public function color()
     {
         switch ($this->name) {

app/Models/WorkshopBalance.php

@@ -50,7 +50,7 @@ public function workshop()
     }
 
     /**
-     * Returns the semester the balance has been calculated for.
+     * Returns the semester the balance belongs to.
      */
     public function semester()
     {