{"action":"created","issue":{"url":"https://api.github.com/repos/playframework/playframework/issues/4287","labels_url":"https://api.github.com/repos/playframework/playframework/issues/4287/labels{/name}","comments_url":"https://api.github.com/repos/playframework/playframework/issues/4287/comments","events_url":"https://api.github.com/repos/playframework/playframework/issues/4287/events","html_url":"https://github.com/playframework/playframework/issues/4287","id":70690141,"number":4287,"title":"2.4.0-RC1 Migration Guide Doc Error","user":{"login":"mslinn","id":485818,"avatar_url":"https://avatars.githubusercontent.com/u/485818?v=3","gravatar_id":"","url":"https://api.github.com/users/mslinn","html_url":"https://github.com/mslinn","followers_url":"https://api.github.com/users/mslinn/followers","following_url":"https://api.github.com/users/mslinn/following{/other_user}","gists_url":"https://api.github.com/users/mslinn/gists{/gist_id}","starred_url":"https://api.github.com/users/mslinn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mslinn/subscriptions","organizations_url":"https://api.github.com/users/mslinn/orgs","repos_url":"https://api.github.com/users/mslinn/repos","events_url":"https://api.github.com/users/mslinn/events{/privacy}","received_events_url":"https://api.github.com/users/mslinn/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/playframework/playframework/labels/documentation","name":"documentation","color":"bfdadc"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/playframework/playframework/milestones/16","html_url":"https://github.com/playframework/playframework/milestones/2.4.0","labels_url":"https://api.github.com/repos/playframework/playframework/milestones/16/labels","id":699619,"number":16,"title":"2.4.0","description":"","creator":{"login":"jroper","id":105833,"avatar_url":"https://avatars.githubusercontent.com/u/105833?v=3","gravatar_id":"","url":"https://api.github.com/users/jroper","html_url":"https://github.com/jroper","followers_url":"https://api.github.com/users/jroper/followers","following_url":"https://api.github.com/users/jroper/following{/other_user}","gists_url":"https://api.github.com/users/jroper/gists{/gist_id}","starred_url":"https://api.github.com/users/jroper/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jroper/subscriptions","organizations_url":"https://api.github.com/users/jroper/orgs","repos_url":"https://api.github.com/users/jroper/repos","events_url":"https://api.github.com/users/jroper/events{/privacy}","received_events_url":"https://api.github.com/users/jroper/received_events","type":"User","site_admin":false},"open_issues":10,"closed_issues":57,"state":"open","created_at":"2014-06-24T06:48:17Z","updated_at":"2015-04-25T21:59:51Z","due_on":null,"closed_at":null},"comments":1,"created_at":"2015-04-24T13:25:28Z","updated_at":"2015-04-27T01:34:09Z","closed_at":null,"body":"Instead of this:\r\n\r\n    addSbtPlugin(\"com.typesafe.play\" % \"sbt-plugin\" % \"2.4.0\")\r\n\r\nThe [migration guide](https://www.playframework.com/documentation/2.4.0-RC1/Migration24) should say this:\r\n\r\n    addSbtPlugin(\"com.typesafe.play\" % \"sbt-plugin\" % \"2.4.0-RC1\")"},"comment":{"url":"https://api.github.com/repos/playframework/playframework/issues/comments/96458378","html_url":"https://github.com/playframework/playframework/issues/4287#issuecomment-96458378","issue_url":"https://api.github.com/repos/playframework/playframework/issues/4287","id":96458378,"user":{"login":"jroper","id":105833,"avatar_url":"https://avatars.githubusercontent.com/u/105833?v=3","gravatar_id":"","url":"https://api.github.com/users/jroper","html_url":"https://github.com/jroper","followers_url":"https://api.github.com/users/jroper/followers","following_url":"https://api.github.com/users/jroper/following{/other_user}","gists_url":"https://api.github.com/users/jroper/gists{/gist_id}","starred_url":"https://api.github.com/users/jroper/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jroper/subscriptions","organizations_url":"https://api.github.com/users/jroper/orgs","repos_url":"https://api.github.com/users/jroper/repos","events_url":"https://api.github.com/users/jroper/events{/privacy}","received_events_url":"https://api.github.com/users/jroper/received_events","type":"User","site_admin":false},"created_at":"2015-04-27T01:34:09Z","updated_at":"2015-04-27T01:34:09Z","body":"I don't know that we have a good solution for this - the docs are fairly static, and we don't want to have to manually update every version mentioned in the docs every time we cut a release.  We do support a `%PLAY_VERSION%` variable that can be put into the docs, but we can't use that here, because the 2.4 migration guide must only have a 2.4 version there, when we move to Play 3, that will end up being substituted with `3.0.0`, which would be wrong (similarly, consider the Play 2.3 migration docs, if we used `%PLAY_VERSION%` in there, it would now say `2.4.0-RC1`.\r\n\r\nThe approach I've taken here has been to choose the version that will become valid once Play 2.4.0 is released.\r\n\r\nIf anyone has any suggestions for a nicer way to address this, I'd love to hear them."}}