{"action":"created","comment":{"url":"https://api.github.com/repos/symfony/symfony-docs/pulls/comments/40148341","id":40148341,"diff_hunk":"@@ -218,3 +218,56 @@ You can change the inner service name if you want to:\n             ->addArgument(new Reference('bar.wooz'))\n             ->setPublic(false)\n             ->setDecoratedService('foo', 'bar.wooz');\n+\n+Deprecating Services\n+--------------------\n+\n+Once you have decided to deprecate the use of a service (because it is outdated,\n+or you decided not to use and maintain it anymore), you can deprecate its\n+definition:\n+\n+.. configuration-block::\n+\n+    .. code-block:: yaml\n+\n+       bar:\n+         class: stdClass\n+         deprecated: true\n+         deprecation_template: The \"%service_id%\" service is deprecated since 2.8, and will be removed in 3.0.","path":"components/dependency_injection/advanced.rst","position":19,"original_position":19,"commit_id":"ca61a23f3a6aca466602dcf7ed1812f6feb1acf9","original_commit_id":"ca61a23f3a6aca466602dcf7ed1812f6feb1acf9","user":{"login":"xabbuh","id":1957048,"avatar_url":"https://avatars.githubusercontent.com/u/1957048?v=3","gravatar_id":"","url":"https://api.github.com/users/xabbuh","html_url":"https://github.com/xabbuh","followers_url":"https://api.github.com/users/xabbuh/followers","following_url":"https://api.github.com/users/xabbuh/following{/other_user}","gists_url":"https://api.github.com/users/xabbuh/gists{/gist_id}","starred_url":"https://api.github.com/users/xabbuh/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xabbuh/subscriptions","organizations_url":"https://api.github.com/users/xabbuh/orgs","repos_url":"https://api.github.com/users/xabbuh/repos","events_url":"https://api.github.com/users/xabbuh/events{/privacy}","received_events_url":"https://api.github.com/users/xabbuh/received_events","type":"User","site_admin":false},"body":"Imho you should remove the comma before \"and\" (same below).","created_at":"2015-09-22T21:42:29Z","updated_at":"2015-09-22T21:42:29Z","html_url":"https://github.com/symfony/symfony-docs/pull/5689#discussion_r40148341","pull_request_url":"https://api.github.com/repos/symfony/symfony-docs/pulls/5689","_links":{"self":{"href":"https://api.github.com/repos/symfony/symfony-docs/pulls/comments/40148341"},"html":{"href":"https://github.com/symfony/symfony-docs/pull/5689#discussion_r40148341"},"pull_request":{"href":"https://api.github.com/repos/symfony/symfony-docs/pulls/5689"}}},"pull_request":{"url":"https://api.github.com/repos/symfony/symfony-docs/pulls/5689","id":44763399,"html_url":"https://github.com/symfony/symfony-docs/pull/5689","diff_url":"https://github.com/symfony/symfony-docs/pull/5689.diff","patch_url":"https://github.com/symfony/symfony-docs/pull/5689.patch","issue_url":"https://api.github.com/repos/symfony/symfony-docs/issues/5689","number":5689,"state":"open","locked":false,"title":"[DI] Add some documentation for the deprecation feature","user":{"login":"Taluu","id":239685,"avatar_url":"https://avatars.githubusercontent.com/u/239685?v=3","gravatar_id":"","url":"https://api.github.com/users/Taluu","html_url":"https://github.com/Taluu","followers_url":"https://api.github.com/users/Taluu/followers","following_url":"https://api.github.com/users/Taluu/following{/other_user}","gists_url":"https://api.github.com/users/Taluu/gists{/gist_id}","starred_url":"https://api.github.com/users/Taluu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Taluu/subscriptions","organizations_url":"https://api.github.com/users/Taluu/orgs","repos_url":"https://api.github.com/users/Taluu/repos","events_url":"https://api.github.com/users/Taluu/events{/privacy}","received_events_url":"https://api.github.com/users/Taluu/received_events","type":"User","site_admin":false},"body":"| Q             | A\r\n| ------------- | ---\r\n| Doc fix?      | no\r\n| New docs?     | yes symfony/symfony#15491\r\n| Applies to    | 2.8+\r\n| Fixed tickets | ~\r\n\r\nDocument the deprecation feature I introduced in symfony/symfony#15491","created_at":"2015-09-11T09:40:21Z","updated_at":"2015-09-22T21:42:29Z","closed_at":null,"merged_at":null,"merge_commit_sha":"bebcd175861f3401b520123344849fd6f59cf0ce","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/symfony/symfony-docs/pulls/5689/commits","review_comments_url":"https://api.github.com/repos/symfony/symfony-docs/pulls/5689/comments","review_comment_url":"https://api.github.com/repos/symfony/symfony-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/symfony/symfony-docs/issues/5689/comments","statuses_url":"https://api.github.com/repos/symfony/symfony-docs/statuses/ca61a23f3a6aca466602dcf7ed1812f6feb1acf9","head":{"label":"Taluu:deprecated-docs","ref":"deprecated-docs","sha":"ca61a23f3a6aca466602dcf7ed1812f6feb1acf9","user":{"login":"Taluu","id":239685,"avatar_url":"https://avatars.githubusercontent.com/u/239685?v=3","gravatar_id":"","url":"https://api.github.com/users/Taluu","html_url":"https://github.com/Taluu","followers_url":"https://api.github.com/users/Taluu/followers","following_url":"https://api.github.com/users/Taluu/following{/other_user}","gists_url":"https://api.github.com/users/Taluu/gists{/gist_id}","starred_url":"https://api.github.com/users/Taluu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Taluu/subscriptions","organizations_url":"https://api.github.com/users/Taluu/orgs","repos_url":"https://api.github.com/users/Taluu/repos","events_url":"https://api.github.com/users/Taluu/events{/privacy}","received_events_url":"https://api.github.com/users/Taluu/received_events","type":"User","site_admin":false},"repo":{"id":42299085,"name":"symfony-docs","full_name":"Taluu/symfony-docs","owner":{"login":"Taluu","id":239685,"avatar_url":"https://avatars.githubusercontent.com/u/239685?v=3","gravatar_id":"","url":"https://api.github.com/users/Taluu","html_url":"https://github.com/Taluu","followers_url":"https://api.github.com/users/Taluu/followers","following_url":"https://api.github.com/users/Taluu/following{/other_user}","gists_url":"https://api.github.com/users/Taluu/gists{/gist_id}","starred_url":"https://api.github.com/users/Taluu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Taluu/subscriptions","organizations_url":"https://api.github.com/users/Taluu/orgs","repos_url":"https://api.github.com/users/Taluu/repos","events_url":"https://api.github.com/users/Taluu/events{/privacy}","received_events_url":"https://api.github.com/users/Taluu/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/Taluu/symfony-docs","description":"The Symfony documentation","fork":true,"url":"https://api.github.com/repos/Taluu/symfony-docs","forks_url":"https://api.github.com/repos/Taluu/symfony-docs/forks","keys_url":"https://api.github.com/repos/Taluu/symfony-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Taluu/symfony-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Taluu/symfony-docs/teams","hooks_url":"https://api.github.com/repos/Taluu/symfony-docs/hooks","issue_events_url":"https://api.github.com/repos/Taluu/symfony-docs/issues/events{/number}","events_url":"https://api.github.com/repos/Taluu/symfony-docs/events","assignees_url":"https://api.github.com/repos/Taluu/symfony-docs/assignees{/user}","branches_url":"https://api.github.com/repos/Taluu/symfony-docs/branches{/branch}","tags_url":"https://api.github.com/repos/Taluu/symfony-docs/tags","blobs_url":"https://api.github.com/repos/Taluu/symfony-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Taluu/symfony-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Taluu/symfony-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/Taluu/symfony-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Taluu/symfony-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/Taluu/symfony-docs/languages","stargazers_url":"https://api.github.com/repos/Taluu/symfony-docs/stargazers","contributors_url":"https://api.github.com/repos/Taluu/symfony-docs/contributors","subscribers_url":"https://api.github.com/repos/Taluu/symfony-docs/subscribers","subscription_url":"https://api.github.com/repos/Taluu/symfony-docs/subscription","commits_url":"https://api.github.com/repos/Taluu/symfony-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/Taluu/symfony-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/Taluu/symfony-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/Taluu/symfony-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/Taluu/symfony-docs/contents/{+path}","compare_url":"https://api.github.com/repos/Taluu/symfony-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Taluu/symfony-docs/merges","archive_url":"https://api.github.com/repos/Taluu/symfony-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Taluu/symfony-docs/downloads","issues_url":"https://api.github.com/repos/Taluu/symfony-docs/issues{/number}","pulls_url":"https://api.github.com/repos/Taluu/symfony-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/Taluu/symfony-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/Taluu/symfony-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Taluu/symfony-docs/labels{/name}","releases_url":"https://api.github.com/repos/Taluu/symfony-docs/releases{/id}","created_at":"2015-09-11T09:14:50Z","updated_at":"2015-09-11T09:14:54Z","pushed_at":"2015-09-21T09:54:37Z","git_url":"git://github.com/Taluu/symfony-docs.git","ssh_url":"git@github.com:Taluu/symfony-docs.git","clone_url":"https://github.com/Taluu/symfony-docs.git","svn_url":"https://github.com/Taluu/symfony-docs","homepage":"http://symfony.com/doc","size":31223,"stargazers_count":0,"watchers_count":0,"language":"C++","has_issues":false,"has_downloads":false,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"2.8"}},"base":{"label":"symfony:2.8","ref":"2.8","sha":"de141d51968f51e703cb1574d13628d80fb0cded","user":{"login":"symfony","id":143937,"avatar_url":"https://avatars.githubusercontent.com/u/143937?v=3","gravatar_id":"","url":"https://api.github.com/users/symfony","html_url":"https://github.com/symfony","followers_url":"https://api.github.com/users/symfony/followers","following_url":"https://api.github.com/users/symfony/following{/other_user}","gists_url":"https://api.github.com/users/symfony/gists{/gist_id}","starred_url":"https://api.github.com/users/symfony/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/symfony/subscriptions","organizations_url":"https://api.github.com/users/symfony/orgs","repos_url":"https://api.github.com/users/symfony/repos","events_url":"https://api.github.com/users/symfony/events{/privacy}","received_events_url":"https://api.github.com/users/symfony/received_events","type":"Organization","site_admin":false},"repo":{"id":521583,"name":"symfony-docs","full_name":"symfony/symfony-docs","owner":{"login":"symfony","id":143937,"avatar_url":"https://avatars.githubusercontent.com/u/143937?v=3","gravatar_id":"","url":"https://api.github.com/users/symfony","html_url":"https://github.com/symfony","followers_url":"https://api.github.com/users/symfony/followers","following_url":"https://api.github.com/users/symfony/following{/other_user}","gists_url":"https://api.github.com/users/symfony/gists{/gist_id}","starred_url":"https://api.github.com/users/symfony/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/symfony/subscriptions","organizations_url":"https://api.github.com/users/symfony/orgs","repos_url":"https://api.github.com/users/symfony/repos","events_url":"https://api.github.com/users/symfony/events{/privacy}","received_events_url":"https://api.github.com/users/symfony/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/symfony/symfony-docs","description":"The Symfony documentation","fork":false,"url":"https://api.github.com/repos/symfony/symfony-docs","forks_url":"https://api.github.com/repos/symfony/symfony-docs/forks","keys_url":"https://api.github.com/repos/symfony/symfony-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/symfony/symfony-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/symfony/symfony-docs/teams","hooks_url":"https://api.github.com/repos/symfony/symfony-docs/hooks","issue_events_url":"https://api.github.com/repos/symfony/symfony-docs/issues/events{/number}","events_url":"https://api.github.com/repos/symfony/symfony-docs/events","assignees_url":"https://api.github.com/repos/symfony/symfony-docs/assignees{/user}","branches_url":"https://api.github.com/repos/symfony/symfony-docs/branches{/branch}","tags_url":"https://api.github.com/repos/symfony/symfony-docs/tags","blobs_url":"https://api.github.com/repos/symfony/symfony-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/symfony/symfony-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/symfony/symfony-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/symfony/symfony-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/symfony/symfony-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/symfony/symfony-docs/languages","stargazers_url":"https://api.github.com/repos/symfony/symfony-docs/stargazers","contributors_url":"https://api.github.com/repos/symfony/symfony-docs/contributors","subscribers_url":"https://api.github.com/repos/symfony/symfony-docs/subscribers","subscription_url":"https://api.github.com/repos/symfony/symfony-docs/subscription","commits_url":"https://api.github.com/repos/symfony/symfony-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/symfony/symfony-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/symfony/symfony-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/symfony/symfony-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/symfony/symfony-docs/contents/{+path}","compare_url":"https://api.github.com/repos/symfony/symfony-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/symfony/symfony-docs/merges","archive_url":"https://api.github.com/repos/symfony/symfony-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/symfony/symfony-docs/downloads","issues_url":"https://api.github.com/repos/symfony/symfony-docs/issues{/number}","pulls_url":"https://api.github.com/repos/symfony/symfony-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/symfony/symfony-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/symfony/symfony-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/symfony/symfony-docs/labels{/name}","releases_url":"https://api.github.com/repos/symfony/symfony-docs/releases{/id}","created_at":"2010-02-17T08:43:51Z","updated_at":"2015-09-22T06:12:06Z","pushed_at":"2015-09-22T15:18:24Z","git_url":"git://github.com/symfony/symfony-docs.git","ssh_url":"git@github.com:symfony/symfony-docs.git","clone_url":"https://github.com/symfony/symfony-docs.git","svn_url":"https://github.com/symfony/symfony-docs","homepage":"http://symfony.com/doc","size":64315,"stargazers_count":1037,"watchers_count":1037,"language":"C++","has_issues":true,"has_downloads":false,"has_wiki":false,"has_pages":false,"forks_count":2021,"mirror_url":null,"open_issues_count":296,"forks":2021,"open_issues":296,"watchers":1037,"default_branch":"2.8"}},"_links":{"self":{"href":"https://api.github.com/repos/symfony/symfony-docs/pulls/5689"},"html":{"href":"https://github.com/symfony/symfony-docs/pull/5689"},"issue":{"href":"https://api.github.com/repos/symfony/symfony-docs/issues/5689"},"comments":{"href":"https://api.github.com/repos/symfony/symfony-docs/issues/5689/comments"},"review_comments":{"href":"https://api.github.com/repos/symfony/symfony-docs/pulls/5689/comments"},"review_comment":{"href":"https://api.github.com/repos/symfony/symfony-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/symfony/symfony-docs/pulls/5689/commits"},"statuses":{"href":"https://api.github.com/repos/symfony/symfony-docs/statuses/ca61a23f3a6aca466602dcf7ed1812f6feb1acf9"}}}}