{"action":"created","issue":{"url":"https://api.github.com/repos/Elgg/Elgg/issues/7714","labels_url":"https://api.github.com/repos/Elgg/Elgg/issues/7714/labels{/name}","comments_url":"https://api.github.com/repos/Elgg/Elgg/issues/7714/comments","events_url":"https://api.github.com/repos/Elgg/Elgg/issues/7714/events","html_url":"https://github.com/Elgg/Elgg/issues/7714","id":52605566,"number":7714,"title":"PHPStorm displays strike through @internal functions","user":{"login":"mrclay","id":170687,"avatar_url":"https://avatars.githubusercontent.com/u/170687?v=3","gravatar_id":"","url":"https://api.github.com/users/mrclay","html_url":"https://github.com/mrclay","followers_url":"https://api.github.com/users/mrclay/followers","following_url":"https://api.github.com/users/mrclay/following{/other_user}","gists_url":"https://api.github.com/users/mrclay/gists{/gist_id}","starred_url":"https://api.github.com/users/mrclay/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mrclay/subscriptions","organizations_url":"https://api.github.com/users/mrclay/orgs","repos_url":"https://api.github.com/users/mrclay/repos","events_url":"https://api.github.com/users/mrclay/events{/privacy}","received_events_url":"https://api.github.com/users/mrclay/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/Elgg/Elgg/labels/dev%20usability","name":"dev usability","color":"444444"},{"url":"https://api.github.com/repos/Elgg/Elgg/labels/docs","name":"docs","color":"DDDDDD"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2014-12-21T20:43:47Z","updated_at":"2015-05-27T13:55:23Z","closed_at":null,"body":"Unfortunately it looks like there are [two different usages](http://phpdoc.org/docs/latest/references/phpdoc/tags/internal.html) for `@internal`: leave notes about internal workings, or mark an API as for internal use only. We're using it to display internal notes about functions like elgg_register_plugin_hook_handler(), and PHPStorm 8.0.2 displays them like deprecated functions.\r\n\r\nYes, PHPStorm made this change in a bug fix release :-1:"},"comment":{"url":"https://api.github.com/repos/Elgg/Elgg/issues/comments/105920433","html_url":"https://github.com/Elgg/Elgg/issues/7714#issuecomment-105920433","issue_url":"https://api.github.com/repos/Elgg/Elgg/issues/7714","id":105920433,"user":{"login":"GaryJones","id":88371,"avatar_url":"https://avatars.githubusercontent.com/u/88371?v=3","gravatar_id":"","url":"https://api.github.com/users/GaryJones","html_url":"https://github.com/GaryJones","followers_url":"https://api.github.com/users/GaryJones/followers","following_url":"https://api.github.com/users/GaryJones/following{/other_user}","gists_url":"https://api.github.com/users/GaryJones/gists{/gist_id}","starred_url":"https://api.github.com/users/GaryJones/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GaryJones/subscriptions","organizations_url":"https://api.github.com/users/GaryJones/orgs","repos_url":"https://api.github.com/users/GaryJones/repos","events_url":"https://api.github.com/users/GaryJones/events{/privacy}","received_events_url":"https://api.github.com/users/GaryJones/received_events","type":"User","site_admin":false},"created_at":"2015-05-27T13:55:23Z","updated_at":"2015-05-27T13:55:23Z","body":"Use the inline version `{@internal Some note here }}` as per https://github.com/phpDocumentor/fig-standards/blob/master/proposed/phpdoc.md#examples-7 to leave notes for developers."}}