{"action":"created","issue":{"url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/96","labels_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/96/labels{/name}","comments_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/96/comments","events_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/96/events","html_url":"https://github.com/phpDocumentor/fig-standards/issues/96","id":101285256,"number":96,"title":"Consistent naming convetions for tag names.","user":{"login":"Fleshgrinder","id":1059453,"avatar_url":"https://avatars.githubusercontent.com/u/1059453?v=3","gravatar_id":"","url":"https://api.github.com/users/Fleshgrinder","html_url":"https://github.com/Fleshgrinder","followers_url":"https://api.github.com/users/Fleshgrinder/followers","following_url":"https://api.github.com/users/Fleshgrinder/following{/other_user}","gists_url":"https://api.github.com/users/Fleshgrinder/gists{/gist_id}","starred_url":"https://api.github.com/users/Fleshgrinder/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Fleshgrinder/subscriptions","organizations_url":"https://api.github.com/users/Fleshgrinder/orgs","repos_url":"https://api.github.com/users/Fleshgrinder/repos","events_url":"https://api.github.com/users/Fleshgrinder/events{/privacy}","received_events_url":"https://api.github.com/users/Fleshgrinder/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-08-16T18:01:38Z","updated_at":"2015-09-07T10:21:23Z","closed_at":null,"body":"The current ABNF for tag names is `(ALPHA / \"\\\") *(ALPHA / DIGIT / \"\\\" / \"-\" / \"_\")`.\r\n\r\nFirst obvious problem is that the dash collides with the planned vendor prefixes, see #95 as well.\r\n\r\nOther than that there seems to be no real consistent naming convention for standard tag names. Most tags in userland (especially PHPUnit, Symfony, Doctrine, but many more) are `camelCase` or `CamelCase`. Re-introduction of `@property-read` and `@property-write` are currently discussed that would collide (again) with the planned vendor prefixes and would deviate from all other tag names that exist in the standard as of yet (see #15, #37, and #94 for comments regarding the consistency problem).\r\n\r\n**I propose to standardize only `camelCase` tag names, now and in the future.**\r\n\r\nI further propose* to use the newly planned specialization feature for the previously mentioned `@property-read` and `@property-write` annotations. This would result in `@property:read` and `@property:write`. Adoption would be easy because current implementations would only need to exchange the dash with the colon. The backwards compatibility break is widespread but not severe and the fix is trivial. We also have an example for the specialization usage in the standard, which is a good thing.\r\n\r\n*) I do not think that it would be helpful to open yet another issue for this topic. We have to agree upon the conventions for tag names once and for all and this decision will also dictate how the `@property` specializations are handled."},"comment":{"url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/comments/138261396","html_url":"https://github.com/phpDocumentor/fig-standards/issues/96#issuecomment-138261396","issue_url":"https://api.github.com/repos/phpDocumentor/fig-standards/issues/96","id":138261396,"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},"created_at":"2015-09-07T10:21:23Z","updated_at":"2015-09-07T10:21:23Z","body":"For the record: there is officially no standard for that mentioned in the PSR itself because this is merely a convention. Tag names are case insensitive"}}