GitHub PullRequestReviewCommentEvent at 2014-02-20 14:47:13
Repository: symfony-docs
Actor: cordoval
Payload: {"comment":{"url":"https://api.github.com/repos/symfony/symfony-docs/pulls/comments/9908040","id":9908040,"diff_hunk":"@@ -0,0 +1,306 @@\n+Our Backwards Compatibility Promise\n+===================================\n+\n+If you are using Symfony, we promise you backwards compatibility (BC) for all\n+minor releases (2.5, 2.6, etc.). Ensuring smooth upgrades of your projects is our\n+first priority. However, backwards compatibility comes in many different flavors.\n+\n+.. caution::\n+\n+    This promise was introduced with Symfony 2.3 and does not apply to previous\n+    versions of Symfony.\n+\n+This page has two different target audiences: If you are using Symfony, it will\n+tell you how to make sure that you will be able to upgrade smoothly to all\n+future 2.x versions. If you are contributing to Symfony, this page will tell you\n+the rules that you need to follow to ensure smooth upgrades for our users.\n+\n+Using Symfony Code\n+------------------\n+\n+If you are using Symfony in your projects, the following guidelines will help\n+you to ensure smooth upgrades to all future minor releases of Symfony (such as\n+2.5, 2.6 and so on).\n+\n+Using Our Interfaces\n+~~~~~~~~~~~~~~~~~~~~\n+\n+All interfaces shipped with Symfony can be used in type hints. You can also call\n+any of the methods that they declare. We guarantee that we won't break code that\n+sticks to these rules.","path":"contributing/code/bc.rst","position":47,"original_position":30,"commit_id":"0717192a561ac497b0d41a348c9872f349cbf963","original_commit_id":"232090698e5b98c13bfcb0bbea0ea79b104e68c4","user":{"login":"cordoval","id":328359,"avatar_url":"https://gravatar.com/avatar/ab2a6b877dd41427c660a3d6a170cc71?d=https%3A%2F%2Fidenticons.github.com%2Fbaab6a6fd290d8efddc3f5e0fa0fdcf1.png&r=x","gravatar_id":"ab2a6b877dd41427c660a3d6a170cc71","url":"https://api.github.com/users/cordoval","html_url":"https://github.com/cordoval","followers_url":"https://api.github.com/users/cordoval/followers","following_url":"https://api.github.com/users/cordoval/following{/other_user}","gists_url":"https://api.github.com/users/cordoval/gists{/gist_id}","starred_url":"https://api.github.com/users/cordoval/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cordoval/subscriptions","organizations_url":"https://api.github.com/users/cordoval/orgs","repos_url":"https://api.github.com/users/cordoval/repos","events_url":"https://api.github.com/users/cordoval/events{/privacy}","received_events_url":"https://api.github.com/users/cordoval/received_events","type":"User","site_admin":false},"body":"I think he is saying that is a trade off, not all interfaces have the same importance or relevance. The outer or higher level of an interface should be regarded as strongly tied to the promise, whereas the inner or lesser level interfaces should allow some flexibility on the promise.","created_at":"2014-02-20T14:47:13Z","updated_at":"2014-02-20T14:47:13Z","html_url":"https://github.com/symfony/symfony-docs/pull/3439#discussion_r9908040","pull_request_url":"https://api.github.com/repos/symfony/symfony-docs/pulls/3439","_links":{"self":{"href":"https://api.github.com/repos/symfony/symfony-docs/pulls/comments/9908040"},"html":{"href":"https://github.com/symfony/symfony-docs/pull/3439#discussion_r9908040"},"pull_request":{"href":"https://api.github.com/repos/symfony/symfony-docs/pulls/3439"}}}}