Doc and style

app/Application.php

@@ -61,7 +61,7 @@ public function rev($file, $manifestFile = null)
      * If this installation of Koel has a CDN_URL configured, use it as the base.
      * Otherwise, just use a relative '/'.
      *
-     * @param string The additional resource name/path.
+     * @param string $name The additional resource name/path.
      * 
      * @return string
      */
@@ -72,7 +72,9 @@ public function staticUrl($name = null)
 
     /**
      * Get the latest version number of Koel from Github.
-     * 
+     *
+     * @param Client $client
+     *
      * @return string
      */
     public function getLatestVersion(Client $client = null)

app/Console/Kernel.php

@@ -13,15 +13,15 @@ class Kernel extends ConsoleKernel
      * @var array
      */
     protected $commands = [
-        \App\Console\Commands\SyncMedia::class,
-        \App\Console\Commands\Init::class,
-        \App\Console\Commands\GenerateJWTSecret::class,
+        Commands\SyncMedia::class,
+        Commands\Init::class,
+        Commands\GenerateJWTSecret::class,
     ];
 
     /**
      * Define the application's command schedule.
      *
-     * @param \Illuminate\Console\Scheduling\Schedule $schedule
+     * @param Schedule $schedule
      *
      * @return void
      */

app/Events/SongLikeToggled.php

@@ -11,7 +11,7 @@ class SongLikeToggled extends Event
     use SerializesModels;
 
     /**
-     * The ineraction (like/unlike) in action.
+     * The interaction (like/unlike) in action.
      * 
      * @var Interaction
      */
@@ -29,8 +29,6 @@ class SongLikeToggled extends Event
      *
      * @param Interaction $interaction
      * @param User        $user
-     *
-     * @return void
      */
     public function __construct(Interaction $interaction, User $user = null)
     {

app/Events/SongStartedPlaying.php

@@ -26,6 +26,9 @@ class SongStartedPlaying extends Event
 
     /**
      * Create a new event instance.
+     *
+     * @param Song $song
+     * @param User $user
      */
     public function __construct(Song $song, User $user)
     {

app/Http/Controllers/API/UserController.php

@@ -16,7 +16,9 @@ class UserController extends Controller
 {
     /**
      * Log a user in.
-     * 
+     *
+     * @param UserLoginRequest $request
+     *
      * @return \Illuminate\Http\JsonResponse
      */
     public function login(UserLoginRequest $request)

app/Listeners/UpdateLastfmNowPlaying.php

@@ -17,6 +17,8 @@ class UpdateLastfmNowPlaying
 
     /**
      * Create the event listener.
+     *
+     * @param Lastfm $lastfm
      */
     public function __construct(Lastfm $lastfm)
     {

app/Models/User.php

@@ -4,6 +4,11 @@
 
 use Illuminate\Foundation\Auth\User as Authenticatable;
 
+/**
+ * @property array preferences
+ * @property int   id
+ * @property bool  is_admin
+ */
 class User extends Authenticatable
 {
     /**
@@ -80,8 +85,11 @@ public function savePreference($key, $val)
 
     /**
      * An alias to savePreference().
-     * 
+     *
      * @see $this::savePreference
+     *
+     * @param $key
+     * @param $val
      */
     public function setPreference($key, $val)
     {