dgreen15/Update v3-0.md

content/en/service_catalog/service_definitions/v3-0.md

@@ -189,6 +189,18 @@
 ### v3.0 API endpoints
 To view v3.0 API endpoints, see the latest [API documentation][5].
 
+### Migrating to v3.0
+v3.0 supports the same methods of creating metadata as previous version including Github, API, Terraform, Backstage, ServiceNow, and the UI. However, there are new [API endpoints][5] and a new [Terraform module][6] for v3.0.
+
+You can see the [full schema definitions on Github][1]. V3.0 contains the following changes from v2.2:
+- `schema_version` is now `api_version`
+- `kind` field is new to delineate the type of component: service, queue, datastore, system, or API
+- `dd-service` is now `metadata.name`
+- `team` is now `owner` and `additionalOwners` if there are multiple teams
+- `lifecycle`, `tier`, `languages`, and `type` are now under `spec`
+- `links`, `contacts`, and `description`, and `tags` are now under metadata
+- `application` has been enhanced to become its own kind: `system`. It no longer exists as a discrete field on a service
+
 ## Further reading
 
 {{< partial name="whats-next/whats-next.html" >}}
@@ -198,3 +210,5 @@
 [3]: /code_analysis/faq/#identifying-the-code-location-in-the-service-catalog
 [4]: https://en.wikipedia.org/wiki/Glob_(programming)
 [5]: /api/latest/software-catalog/
+[6]: https://registry.terraform.io/providers/DataDog/datadog/latest/docs/resources/software_catalog
+[7]: service_catalog/customize/import_entries_backstage