clarify contact name/organization

[tomkralidis]

The current contact schema describes contact name / organization as follows:

  name:
    type: string
    description: |-
      The name of the organization or the individual.
  organization:
    type: string
    description:
      Organization/affiliation of the individual/responsible person. In
      case of an organization, the name property should be used and this
      property is not to be used.

name is a required property.

Is implementing name or organization, then, domain/activity specific? For example, consider a catalogue implementing facets on contact organizations. Would the catalogue have to check if organization exists? If not, then use name and assume name is an organization?

Should we consider a contact to require ~ONE OF~ ANY OF name or organization, with clear definitions of each?

cc @pvretano @kalxas @m-mohr @pvgenuchten

[m-mohr]

I think this is good as it is. name specifies the name of the entity and organization is just use for an individual that is affiliated with a company. But maybe we need to clarify this.

[pvgenuchten]

3 cases could be captured

• reference to an individual (common in academia, eg. author(s), no institute, contact.identifier could contain orchid-id)
• reference to an organization, no individual (common in governmental organizations, contact.identifier could contain organization-uri)
• reference to an individual within an organization (contact.identifier contains either individual id or organisation id)

When using name only, it is impossible to distinguish case 1 from case 2

[tomkralidis]

2023-07-05: agreement to move forward with proposal. I will issue a PR.

[m-mohr]

Above it says "ONE OF" for name and organization. Does this mean you can't provide both name and organization?

[tomkralidis]

Changed to ANY OF

[m-mohr]

~"any of" would mean providing none of them is also fine ;-) I guess what it actually meant here is "at least one of".~

[tomkralidis]

So then:

 "oneOf": [
    {
      "allOf": [
        {
          "required": [
            "name"
          ]
        }
      ]
    },
    {
      "allOf": [
        {
          "required": [
            "organization"
          ]
        }
      ]
    }
  ]

[m-mohr]

Sorry @tomkralidis, my fault, I was mixing things up. any of is correct :-)

[tomkralidis]

PR in #296