some docblocks

src/Packagist/WebBundle/Controller/ApiController.php

@@ -181,6 +181,11 @@ class ApiController extends Controller
         return new JsonResponse(array('status' => 'success'), 201);
     }
 
+    /**
+     * @param string $name
+     * @param string $version
+     * @return array
+     */
     protected function getPackageAndVersionId($name, $version)
     {
         return $this->get('doctrine.dbal.default_connection')->fetchAssoc(
@@ -249,6 +254,7 @@ class ApiController extends Controller
         $io->loadConfiguration($config);
 
         try {
+            /** @var Package $package */
             foreach ($packages as $package) {
                 $em->transactional(function($em) use ($package, $updater, $io, $config) {
                     // prepare dependencies

src/Packagist/WebBundle/Controller/UserController.php

@@ -49,6 +49,10 @@ class UserController extends Controller
         );
     }
 
+    /**
+     * @param Request $req
+     * @return Response
+     */
     public function myProfileAction(Request $req)
     {
         $user = $this->container->get('security.token_storage')->getToken()->getUser();
@@ -158,6 +162,11 @@ class UserController extends Controller
         return new Response('{"status": "success"}', 204);
     }
 
+    /**
+     * @param Request $req
+     * @param User $user
+     * @return Pagerfanta
+     */
     protected function getUserPackages($req, $user)
     {
         $packages = $this->getDoctrine()