{"action":"created","issue":{"url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/1536","labels_url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/1536/labels{/name}","comments_url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/1536/comments","events_url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/1536/events","html_url":"https://github.com/phpDocumentor/phpDocumentor2/issues/1536","id":63902420,"number":1536,"title":"Allow File summary AFTER namespace?","user":{"login":"lamoni","id":5675626,"avatar_url":"https://avatars.githubusercontent.com/u/5675626?v=3","gravatar_id":"","url":"https://api.github.com/users/lamoni","html_url":"https://github.com/lamoni","followers_url":"https://api.github.com/users/lamoni/followers","following_url":"https://api.github.com/users/lamoni/following{/other_user}","gists_url":"https://api.github.com/users/lamoni/gists{/gist_id}","starred_url":"https://api.github.com/users/lamoni/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lamoni/subscriptions","organizations_url":"https://api.github.com/users/lamoni/orgs","repos_url":"https://api.github.com/users/lamoni/repos","events_url":"https://api.github.com/users/lamoni/events{/privacy}","received_events_url":"https://api.github.com/users/lamoni/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-03-24T04:46:36Z","updated_at":"2015-03-24T12:31:15Z","closed_at":null,"body":"Hello all,\r\n\r\nRunning into the \"No summary was found for this file\" on Line 0 issue with files, and realized it was due to the fact I'm following the \"Laravel way\" of putting the class's namespace immediately after the opening <?php tags, example:\r\n\r\n```php\r\n<?php namespace MyApp\\Controllers;\r\n\r\n/**\r\n* This is supposed to be a file summary but won't be parsed as such due to the namespace\r\n*/\r\n```\r\n\r\nIf I change this to:\r\n\r\n```php\r\n<?php\r\n/**\r\n* This will work just fine and I won't get the line 0 \"No summary was found for this file\" error\r\n*/\r\nnamespace MyApp\\Controllers;\r\n```\r\n\r\nI'm not sure if this is something we should fix with PHPDocs or if Laravel needs to change its suggestions, or if I'm just missing something obvious (the most likely)."},"comment":{"url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/comments/85478912","html_url":"https://github.com/phpDocumentor/phpDocumentor2/issues/1536#issuecomment-85478912","issue_url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/1536","id":85478912,"user":{"login":"boenrobot","id":1029536,"avatar_url":"https://avatars.githubusercontent.com/u/1029536?v=3","gravatar_id":"","url":"https://api.github.com/users/boenrobot","html_url":"https://github.com/boenrobot","followers_url":"https://api.github.com/users/boenrobot/followers","following_url":"https://api.github.com/users/boenrobot/following{/other_user}","gists_url":"https://api.github.com/users/boenrobot/gists{/gist_id}","starred_url":"https://api.github.com/users/boenrobot/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/boenrobot/subscriptions","organizations_url":"https://api.github.com/users/boenrobot/orgs","repos_url":"https://api.github.com/users/boenrobot/repos","events_url":"https://api.github.com/users/boenrobot/events{/privacy}","received_events_url":"https://api.github.com/users/boenrobot/received_events","type":"User","site_admin":false},"created_at":"2015-03-24T12:31:15Z","updated_at":"2015-03-24T12:31:15Z","body":"Do Laravel's suggestions suggest a file comment at all? A lot of frameworks suggest you keep one class/interface/trait per file, and put the comment on it, omitting the file comment entirely.\r\n\r\nThose that *do* suggest a file comment... Should suggest it be above the namespace."}}