Update upgrading.md (#333)

mars · web-flow · commit f6877e11a42a · 2022-02-21T16:55:21.000-08:00
diff --git a/docs/guides/upgrading.md b/docs/guides/upgrading.md
@@ -44,9 +44,9 @@ resource "heroku_addon" "example" {
 }
 ```
 
-### 2. Replace `heroku_app` data source result references with `app_id`
+### 2. Replace `heroku_app` data source result references with `id`
 
-If you use this data source, its app ID output has changed from `app` to `app_id`.
+The app data source `id` attribute now contains the app UUID, not the app name. As long as `id` is used for `app_id` references, then no further configuration changes are required. Setting `app_id` references from `name` is no longer allowed, and must be updated to `id`, like `data.heroku_app.example.id`.
 
 ## Verify configuration changes
 

Original file line number	Diff line number	Diff line change
`@@ -44,9 +44,9 @@ resource "heroku_addon" "example" {`
`44`	`44`	`}`
`45`	`45`	```
`46`	`46`
`47`		-### 2. Replace `heroku_app` data source result references with `app_id`
	`47`	+### 2. Replace `heroku_app` data source result references with `id`
`48`	`48`
`49`		-If you use this data source, its app ID output has changed from `app` to `app_id`.
	`49`	+The app data source `id` attribute now contains the app UUID, not the app name. As long as `id` is used for `app_id` references, then no further configuration changes are required. Setting `app_id` references from `name` is no longer allowed, and must be updated to `id`, like `data.heroku_app.example.id`.
`50`	`50`
`51`	`51`	`## Verify configuration changes`
`52`	`52`