{"action":"created","issue":{"url":"https://api.github.com/repos/hashicorp/terraform/issues/2388","labels_url":"https://api.github.com/repos/hashicorp/terraform/issues/2388/labels{/name}","comments_url":"https://api.github.com/repos/hashicorp/terraform/issues/2388/comments","events_url":"https://api.github.com/repos/hashicorp/terraform/issues/2388/events","html_url":"https://github.com/hashicorp/terraform/issues/2388","id":89125706,"number":2388,"title":"Split out top-level aws_route resource","user":{"login":"phinze","id":37534,"avatar_url":"https://avatars.githubusercontent.com/u/37534?v=3","gravatar_id":"","url":"https://api.github.com/users/phinze","html_url":"https://github.com/phinze","followers_url":"https://api.github.com/users/phinze/followers","following_url":"https://api.github.com/users/phinze/following{/other_user}","gists_url":"https://api.github.com/users/phinze/gists{/gist_id}","starred_url":"https://api.github.com/users/phinze/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/phinze/subscriptions","organizations_url":"https://api.github.com/users/phinze/orgs","repos_url":"https://api.github.com/users/phinze/repos","events_url":"https://api.github.com/users/phinze/events{/privacy}","received_events_url":"https://api.github.com/users/phinze/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/hashicorp/terraform/labels/enhancement","name":"enhancement","color":"d4c5f9"},{"url":"https://api.github.com/repos/hashicorp/terraform/labels/provider/aws","name":"provider/aws","color":"bfdadc"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":8,"created_at":"2015-06-17T21:04:27Z","updated_at":"2015-06-22T22:55:30Z","closed_at":null,"body":"Same logic as splitting out other top level resources:\r\n\r\n * routes don't all have to be known at route table definition time\r\n * routes can be dynamically added and removed\r\n * individual routes can be managed on route tables that terraform does not manage\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/hashicorp/terraform/issues/comments/114293408","html_url":"https://github.com/hashicorp/terraform/issues/2388#issuecomment-114293408","issue_url":"https://api.github.com/repos/hashicorp/terraform/issues/2388","id":114293408,"user":{"login":"phinze","id":37534,"avatar_url":"https://avatars.githubusercontent.com/u/37534?v=3","gravatar_id":"","url":"https://api.github.com/users/phinze","html_url":"https://github.com/phinze","followers_url":"https://api.github.com/users/phinze/followers","following_url":"https://api.github.com/users/phinze/following{/other_user}","gists_url":"https://api.github.com/users/phinze/gists{/gist_id}","starred_url":"https://api.github.com/users/phinze/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/phinze/subscriptions","organizations_url":"https://api.github.com/users/phinze/orgs","repos_url":"https://api.github.com/users/phinze/repos","events_url":"https://api.github.com/users/phinze/events{/privacy}","received_events_url":"https://api.github.com/users/phinze/received_events","type":"User","site_admin":false},"created_at":"2015-06-22T22:55:30Z","updated_at":"2015-06-22T22:55:30Z","body":"If you take a look at the [docs for `MigrateState` and `SchemaVersion`](https://github.com/hashicorp/terraform/blob/7850bb39d5465be88ef05e1efb7067788e5cf094/helper/schema/resource.go#L28-L51), you'll see those exist to provide us with hooks for maintaining backwards compatibility as the state config changes. Since you're implementing a new resource, you don't have to worry about them at all. :+1: "}}