{"action":"created","issue":{"url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/37","labels_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/37/labels{/name}","comments_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/37/comments","events_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/37/events","html_url":"https://github.com/phpDocumentor/fig-standards/issues/37","id":23383876,"number":37,"title":"Add new @inheritDoc tag to replace erroneous usage of {@inheritDoc}","user":{"login":"mvriel","id":193704,"avatar_url":"https://avatars.githubusercontent.com/u/193704?v=3","gravatar_id":"","url":"https://api.github.com/users/mvriel","html_url":"https://github.com/mvriel","followers_url":"https://api.github.com/users/mvriel/followers","following_url":"https://api.github.com/users/mvriel/following{/other_user}","gists_url":"https://api.github.com/users/mvriel/gists{/gist_id}","starred_url":"https://api.github.com/users/mvriel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mvriel/subscriptions","organizations_url":"https://api.github.com/users/mvriel/orgs","repos_url":"https://api.github.com/users/mvriel/repos","events_url":"https://api.github.com/users/mvriel/events{/privacy}","received_events_url":"https://api.github.com/users/mvriel/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/phpDocumentor/fig-standards/labels/enhancement","name":"enhancement","color":"84b6eb"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":20,"created_at":"2013-11-27T12:28:23Z","updated_at":"2015-08-15T19:37:14Z","closed_at":null,"body":""},"comment":{"url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/comments/131434067","html_url":"https://github.com/phpDocumentor/fig-standards/issues/37#issuecomment-131434067","issue_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/37","id":131434067,"user":{"login":"mindplay-dk","id":103348,"avatar_url":"https://avatars.githubusercontent.com/u/103348?v=3","gravatar_id":"","url":"https://api.github.com/users/mindplay-dk","html_url":"https://github.com/mindplay-dk","followers_url":"https://api.github.com/users/mindplay-dk/followers","following_url":"https://api.github.com/users/mindplay-dk/following{/other_user}","gists_url":"https://api.github.com/users/mindplay-dk/gists{/gist_id}","starred_url":"https://api.github.com/users/mindplay-dk/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mindplay-dk/subscriptions","organizations_url":"https://api.github.com/users/mindplay-dk/orgs","repos_url":"https://api.github.com/users/mindplay-dk/repos","events_url":"https://api.github.com/users/mindplay-dk/events{/privacy}","received_events_url":"https://api.github.com/users/mindplay-dk/received_events","type":"User","site_admin":false},"created_at":"2015-08-15T19:37:14Z","updated_at":"2015-08-15T19:37:14Z","body":"> whether you use `@inheritDoc` or `@inheritdoc` is not relevant; tags are not case-sensitive\r\n\r\nNoted, though I think we should stick with lowercase in the docs, as a convention?\r\n\r\nI think, the non-case-sensitivity is primarily in-spec because of BC with de-facto standard php-doc, correct? If you could change it without consequence, I think most people would agree that consistency is better, so you intuitively recognize all tags. If someone wanted to write `@INHERITDOC`, for example, I think we can all agree that's a bit wonky?\r\n\r\n(Either way, I'm not trying to change that decision, but I don't think it does serve a practical purpose, and likely changing it would cause very small problems easily fixable with a simple search and replace...)\r\n\r\n> But then again with `property-read` and `property-write` things get inconsistent\r\n\r\nInconsistent with what? Java?\r\n\r\nIs consistency with Java important enough to warrant a break from de-facto standard PHP of this magnitude?\r\n\r\nIf that's what you think, I strongly disagree. The precise syntax of `:` vs `-` to indicate specialization, to me, is not a matter of practicality, but of taste, which to me is completely subordinate to consistency with de-facto standard php-doc.\r\n\r\nA change like this is \"nice to have\", it's definitely not \"must have\" - it doesn't cause any problems, and PHP developers are already familiar with the current syntax. You're the first person I have ever known to remark on that syntax, at all.\r\n"}}