{"action":"closed","issue":{"url":"https://api.github.com/repos/symfony/symfony-docs/issues/6512","repository_url":"https://api.github.com/repos/symfony/symfony-docs","labels_url":"https://api.github.com/repos/symfony/symfony-docs/issues/6512/labels{/name}","comments_url":"https://api.github.com/repos/symfony/symfony-docs/issues/6512/comments","events_url":"https://api.github.com/repos/symfony/symfony-docs/issues/6512/events","html_url":"https://github.com/symfony/symfony-docs/issues/6512","id":150595957,"number":6512,"title":"[Question] [CS] Effort / gain vs respecting CS","user":{"login":"phansys","id":1231441,"avatar_url":"https://avatars.githubusercontent.com/u/1231441?v=3","gravatar_id":"","url":"https://api.github.com/users/phansys","html_url":"https://github.com/phansys","followers_url":"https://api.github.com/users/phansys/followers","following_url":"https://api.github.com/users/phansys/following{/other_user}","gists_url":"https://api.github.com/users/phansys/gists{/gist_id}","starred_url":"https://api.github.com/users/phansys/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/phansys/subscriptions","organizations_url":"https://api.github.com/users/phansys/orgs","repos_url":"https://api.github.com/users/phansys/repos","events_url":"https://api.github.com/users/phansys/events{/privacy}","received_events_url":"https://api.github.com/users/phansys/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/symfony/symfony-docs/labels/needs%20comments","name":"needs comments","color":"5319e7"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":7,"created_at":"2016-04-23T20:53:57Z","updated_at":"2016-05-21T10:42:31Z","closed_at":"2016-05-21T10:42:31Z","body":"I'm opening this ticket because I think we need a clearer definition of what coding standards means for Symfony or which is the weight of each rule defined at [Structure](https://github.com/symfony/symfony-docs/blob/master/contributing/code/standards.rst#structure) section. If they have different levels of importance or respectability, I propose to restructure that chapter in order to use the keywords defined at [RFC 2119](http://www.ietf.org/rfc/rfc2119.txt) (\"MUST\", \"MUST NOT\", \"REQUIRED\", \"SHALL\", \"SHALL NOT\", \"SHOULD\", \"SHOULD NOT\", \"RECOMMENDED\", \"MAY\", and \"OPTIONAL\") as done in [PSR-2](http://www.php-fig.org/psr/psr-2/).\r\n\r\nLately I'm noticing that there are some changes that aren't taken into account because the effort which they can demand or the gain that they can offer. In some cases they are [proposals for new standards](https://github.com/symfony/symfony-docs/issues/6484), but in others they indeed are [fixes for structures that don't respect our established set of rules](https://github.com/symfony/symfony/pull/18624).\r\n\r\nBTW, I only have acknowledgement of both of these examples because I was who proposed them, but I'm suspecting that there could be some other similar cases."}}
{"actor":{"display_login":"WouterJ"}}