Add contributors CR 10-10

[jolla56]

Description of the change: (free-text)

In NewsML-G2, it is possible to indicate a "contributor" to an Item. What is the best way to do the equivalent in ninjs?

We would like to be able to indicate these types of people:

producer
photographer
captionwriter
editor

Should these be their own "top level" properties?

"producer" : "jane",
"photographer" : "sheila",
"captionwriter" : "evan",
"editor" : "alan"

Or, more likely, into lists

"producers" : ["jane", "stan", "bartholomew" ]

And, come to think of it, maybe they should actually be structured, objects - perhaps a "name", "code", "scheme" set of properties, to start?

"producers": [
    {
        "name": "jane",
        "code": "p1",
        "scheme": "https://producers.example.org"
    },
    {
        "name": "stan",
        "code": "p2",
        "scheme": "https://producers.example.org"
    },
    {
        "name": "bartholomew",
        "code": "p3",
        "scheme": "https://producers.example.org"
    }
]

Or should we group them together? e.g. in a "contributors" and just have a "type" property to indicate what kind of contributor they are (I guess with a controlled vocabulary?)

"contributors": [
    {
        "name": "jane",
        "code": "p1",
        "scheme": "https://producers.example.org",
        "type" : "producer"
    },
    {
        "name": "stan",
        "code": "p1",
        "scheme": "https://photographers.example.org",
        "type" : "photographer"
    },
    {
        "name": "bartholomew",
        "code": "p1",
        "scheme": "https://producers.example.org",
        "type" : "editor"
    }
]

Rationale for the change:

We would like to be able to indicate these types of people:

producer
photographer
captionwriter
editor

Reference to related IPTC discussion(s) (on Yahoo groups etc):

Formalised change request: (spec table etc.)

Name: contibutors

Definition: A list of the various people or organizations who have contributed to the item.

Data type: An array of objects. Each contributor object consists of name, code, scheme and type properties.

[jolla56]

JAYSON:

I am okay with adding this, though it does add a bit of complexity. I think I like the 2nd suggestion in the request:

"contributors": [
    {
        "name": "jane",
        "code": "p1",
        "scheme": "https://producers.example.org",
        "type" : "producer"
    },
    {
        "name": "stan",
        "code": "p1",
        "scheme": "https://photographers.example.org",
        "type" : "photographer"
    },
    {
        "name": "bartholomew",
        "code": "p1",
        "scheme": "https://producers.example.org",
        "type" : "editor"
    }
]

I would hope that the type, scheme, and code were optional. Also how about adding a location property, or some sort of open property like: Comment or Note: to add a location?

e.g.

"contributors": [
    {
        "name": "Jayson",
        "location": "SF"
    },
    {
        "name": "Jeremy",
        "location": "NY",
        "comment": "temporarily working in NY",
        "type" : "photographer"
    }
]

[jolla56]

Compare with bylines: #29