You have two options here `/** @var \TheTwelve\Foursquare\HttpClient */` or `/** @var HttpClient */` but not `/** @var TheTwelve\Foursquare\HttpClient */`. PHPDocs are aware of the fact that you are in a namespace already, so you have to give it the full name of the class as it can be found in the global space, or just the name of the class as found in `\TheTwelve\Foursquare`

Reference: http://php.net/manual/en/language.namespaces.global.php