diff --git a/controller/base.php b/controller/base.php
index 53f3007..56e6d3c 100644
--- a/controller/base.php
+++ b/controller/base.php
@@ -25,31 +25,31 @@ abstract class base
 	/** @var auth */
 	protected $auth;
 
-	/* @var config */
+	/** @var config */
 	protected $config;
 
-	/* @var helper */
+	/** @var helper */
 	protected $helper;
 
-	/* @var \phpbb\ideas\factory\base */
+	/** @var \phpbb\ideas\factory\base */
 	protected $entity;
 
 	/** @var language  */
 	protected $language;
 
-	/* @var linkhelper */
+	/** @var linkhelper */
 	protected $link_helper;
 
 	/** @var pagination */
 	protected $pagination;
 
-	/* @var request */
+	/** @var request */
 	protected $request;
 
-	/* @var template */
+	/** @var template */
 	protected $template;
 
-	/* @var user */
+	/** @var user */
 	protected $user;
 
 	/** @var string */
diff --git a/controller/idea_controller.php b/controller/idea_controller.php
index 294a902..dfb2dd8 100644
--- a/controller/idea_controller.php
+++ b/controller/idea_controller.php
@@ -20,7 +20,7 @@ class idea_controller extends base
 	/** @var array of idea data */
 	protected $data;
 
-	/* @var \phpbb\ideas\factory\idea */
+	/** @var \phpbb\ideas\factory\idea */
 	protected $entity;
 
 	/**
diff --git a/controller/index_controller.php b/controller/index_controller.php
index a01f499..bf42096 100644
--- a/controller/index_controller.php
+++ b/controller/index_controller.php
@@ -15,7 +15,7 @@
 
 class index_controller extends base
 {
-	/* @var \phpbb\ideas\factory\ideas */
+	/** @var \phpbb\ideas\factory\ideas */
 	protected $entity;
 
 	/**
diff --git a/controller/list_controller.php b/controller/list_controller.php
index 3465574..b083952 100644
--- a/controller/list_controller.php
+++ b/controller/list_controller.php
@@ -15,7 +15,7 @@
 
 class list_controller extends base
 {
-	/* @var \phpbb\ideas\factory\ideas */
+	/** @var \phpbb\ideas\factory\ideas */
 	protected $entity;
 
 	/**
diff --git a/controller/livesearch_controller.php b/controller/livesearch_controller.php
index 0d77dab..198c7ab 100644
--- a/controller/livesearch_controller.php
+++ b/controller/livesearch_controller.php
@@ -15,7 +15,7 @@
  */
 class livesearch_controller extends base
 {
-	/* @var \phpbb\ideas\factory\livesearch */
+	/** @var \phpbb\ideas\factory\livesearch */
 	protected $entity;
 
 	/**
diff --git a/event/listener.php b/event/listener.php
index 3603895..7ee8c97 100644
--- a/event/listener.php
+++ b/event/listener.php
@@ -26,25 +26,25 @@ class listener implements EventSubscriberInterface
 	/** @var auth */
 	protected $auth;
 
-	/* @var config */
+	/** @var config */
 	protected $config;
 
-	/* @var helper */
+	/** @var helper */
 	protected $helper;
 
-	/* @var idea */
+	/** @var idea */
 	protected $idea;
 
 	/** @var language */
 	protected $language;
 
-	/* @var linkhelper */
+	/** @var linkhelper */
 	protected $link_helper;
 
-	/* @var template */
+	/** @var template */
 	protected $template;
 
-	/* @var user */
+	/** @var user */
 	protected $user;
 
 	/** @var string */
diff --git a/factory/base.php b/factory/base.php
index 397b1a8..2f5b1ce 100644
--- a/factory/base.php
+++ b/factory/base.php
@@ -25,10 +25,10 @@ class base
 	/** @var auth */
 	protected $auth;
 
-	/* @var config */
+	/** @var config */
 	protected $config;
 
-	/* @var driver_interface */
+	/** @var driver_interface */
 	protected $db;
 
 	/** @var language */
@@ -37,7 +37,7 @@ class base
 	/** @var notification_manager */
 	protected $notification_manager;
 
-	/* @var user */
+	/** @var user */
 	protected $user;
 
 	/** @var string */
diff --git a/factory/linkhelper.php b/factory/linkhelper.php
index 0d30f32..a103681 100644
--- a/factory/linkhelper.php
+++ b/factory/linkhelper.php
@@ -18,10 +18,10 @@
  */
 class linkhelper
 {
-	/* @var helper */
+	/** @var helper */
 	protected $helper;
 
-	/* @var user_loader */
+	/** @var user_loader */
 	protected $user_loader;
 
 	/**