diff --git a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/delete.php.twig b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/delete.php.twig
index 05f3f83..b1ab62e 100755
--- a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/delete.php.twig
+++ b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/delete.php.twig
@@ -17,8 +17,7 @@
     * @View(statusCode=204)
     *
     * @param Request $request
-    * @param $entity
-    * @internal param $id
+    * @param $id
     *
     * @return Response
 {% endblock phpdoc_method_header %}
diff --git a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/getById.php.twig b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/getById.php.twig
index 45b14f8..f6f1b42 100755
--- a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/getById.php.twig
+++ b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/getById.php.twig
@@ -17,6 +17,7 @@
     * @View(serializerEnableMaxDepthChecks=true)
     *
     * @return Response
+    * @param $id
 {% endblock phpdoc_method_header %}
 {% block phpdoc_method_annotations %}
     {% if 'annotation' == format %}
diff --git a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/getOr404.php.twig b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/getOr404.php.twig
index 35ded1b..ffbea13 100755
--- a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/getOr404.php.twig
+++ b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/getOr404.php.twig
@@ -1,4 +1,11 @@
-
+  /**
+{% block phpdoc_method_header %}
+    * Get a entity or throw a exception
+    *
+    * @param $id
+    * @return $entity
+{% endblock phpdoc_method_header %}
+    */
 {% block method_definition %}
     protected function getOr404($id)
 {% endblock method_definition %}
diff --git a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/patch.php.twig b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/patch.php.twig
index 15a5878..4a7c498 100755
--- a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/patch.php.twig
+++ b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/patch.php.twig
@@ -18,7 +18,7 @@
     * @View(serializerEnableMaxDepthChecks=true)
     *
     * @param Request $request
-    * @param $entity
+    * @param $id
     *
     * @return Response
 {% endblock phpdoc_method_header %}
diff --git a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/put.php.twig b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/put.php.twig
index 7019fe7..eeb7447 100755
--- a/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/put.php.twig
+++ b/src/Voryx/RESTGeneratorBundle/Resources/skeleton/rest/actions/put.php.twig
@@ -19,7 +19,7 @@
     * @View(serializerEnableMaxDepthChecks=true)
     *
     * @param Request $request
-    * @param $entity
+    * @param $id
     *
     * @return Response
 {% endblock phpdoc_method_header %}