Naming convention for types for partial resource

[pvdbosch]

Partial resource representations are used to refer to a resource within another one's representation and often contain:

• the identifier of the resource
• link to the full representation, if declared within same API
• some key data, like name/description of the code

Should we standardize the naming of the OpenApi types?

Some examples:

  "gender": {
    "description": "female",
    "code": 1
  },

  "deliveryMethod": {
     "code": "deliveredAtHome", 
     "href": "/refData/deliveryMethods/deliveredAtHome"
  },

  "store": {
     "id": 789, 
     "name": "Pet Store Brussels",
     "href": "/stores/789"
  }

I sometimes see the use of suffixes "Reference", "Link", "Summary", ... for the openapi types