The file resourceTypeCatalog.md defines a short name and URI for use in describing resources. However, it could also cause confusion because the OpenAPI discriminator for a resource (resourceType) is the same name as the JSON file for each resource without the file extension. This is described in the generic data exchange API specification, but it is easy to miss if not looking at this file.
Proposal: Add a "Discriminator (resourceType)" column to the resource type catalog markdown file.
The file resourceTypeCatalog.md defines a short name and URI for use in describing resources. However, it could also cause confusion because the OpenAPI discriminator for a resource (
resourceType
) is the same name as the JSON file for each resource without the file extension. This is described in the generic data exchange API specification, but it is easy to miss if not looking at this file.Proposal: Add a "Discriminator (resourceType)" column to the resource type catalog markdown file.