Contributor: have an `Institution Name` alternative to Name/Surname

[PonteIneptique]

If the digitization work is not attributed, attribution to an institution could be a good thing. Or should we have a institutions key, a la contributor, with specific roles ?

[alix-tz]

On the form, it could be something like this:

---

In the schema, yes, we could copy the way the authors property works. I think it would be easier this way.

We might want to rule out a couple of roles (or not).

[alix-tz]

Tu imagines ça comme ça :

"authors": {
        "description": "Contributors to the project",
        "type": "array",
        "items": {
            "type": "object",
            "properties": {
                "name": {
                    "description": "Name of the contributor",
                    "type": "string"
                },
                "surname": {
                    "description": "Surname of the contributor",
                    "type": "string"
                },
                "institution-name": {
                    "description": "Name of the institution",
                    "type": "string"
                },
                "roles": {
                    "description": "Roles the contributor had",
                    "type": "array",
                    "items": {
                        "type": "string",
                        "enum": [
                            "transcriber", "aligner", "project-manager", 
                            "support", "digitization", "quality-control"
                        ]
                    },
                    "uniqueItems": true
                }
            }
        }
    },

(auquel cas il faut pouvoir dire c'est ou bien name, surname + roles ou bien institution-name + roles).

Ou comme un autre bloc comme ça :

"authors": {...},
"institutions": {
        "description": "Institution contributing to the project",
        "type": "array",
        "items": {
            "type": "object",
            "properties": {
                "name": {
                    "description": "Name of the institution",
                    "type": "string"
                },
                "roles": {
                    "description": "Roles the institution had",
                    "type": "array",
                    "items": {
                        "type": "string",
                        "enum": [
                            "transcriber", "aligner", "project-manager", 
                            "support", "digitization", "quality-control"
                        ]
                    },
                    "uniqueItems": true
                }
            }
        }
    },

[PonteIneptique]

I don't know. Can we get Laurent to weight in? (note that I'd like to add orcid in there as well)

Le mar. 22 mars 2022 à 7:26 PM, Alix Chagué @.***> a écrit :

Tu imagine ça comme ça :

"authors": {

    "description": "Contributors to the project",

    "type": "array",

    "items": {

        "type": "object",

        "properties": {

            "name": {

                "description": "Name of the contributor",

                "type": "string"

            },

            "surname": {

                "description": "Surname of the contributor",

                "type": "string"

            },

            "institution-name": {

                "description": "Name of the institution",

                "type": "string"

            },

            "roles": {

                "description": "Roles the contributor had",

                "type": "array",

                "items": {

                    "type": "string",

                    "enum": [

                        "transcriber", "aligner", "project-manager",

                        "support", "digitization", "quality-control"

                    ]

                },

                "uniqueItems": true

            }

        }

    }

},

(auquel cas il faut pouvoir dire c'est ou bien name, surname + roles ou bien institution-name + roles).

Ou comme un autre bloc comme ça :

"authors": {...}, "institutions": {

    "description": "Institution contributing to the project",

    "type": "array",

    "items": {

        "type": "object",

        "properties": {

            "name": {

                "description": "Name of the institution",

                "type": "string"

            },

            "roles": {

                "description": "Roles the institution had",

                "type": "array",

                "items": {

                    "type": "string",

                    "enum": [

                        "transcriber", "aligner", "project-manager",

                        "support", "digitization", "quality-control"

                    ]

                },

                "uniqueItems": true

            }

        }

    }

},

— Reply to this email directly, view it on GitHub https://github.com/HTR-United/schema/issues/2#issuecomment-1075479704, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAOXEZUA3X5UWFDEPG2TA3TVBIGFTANCNFSM5RFME76A . You are receiving this because you were assigned.Message ID: @.***>

[alix-tz]

ORCID is an excellent idea!

EDIT : Done with ➡️ #10

[alix-tz]

@PonteIneptique je propose une troisième voie plus légère, en typant le contributeur (person vs. institution). Qu'en penses-tu ?

"authors": {
        "description": "Contributors to the project",
        "type": "array",
        "items": {
            "type": "object",
            "properties": {
                "type": {
                  "description": "Type of contributor",
                  "type": "string",
                  "enum": ["person", "institution"]
                },
                "name": {
                    "description": "Name of the contributor, full-name for institutions",
                    "type": "string"
                },
                "surname": {
                    "description": "For people, surname of the contributor",
                    "type": "string"
                },
                "orcid": {
                    "description": "Contributor's ORCID identifier",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{4}-\\d{4}-\\d{4}$"
                },
                "roles": {
                    "description": "Roles the contributor had",
                    "type": "array",
                    "items": {
                        "type": "string",
                        "enum": [
                            "transcriber", "aligner", "project-manager", 
                            "support", "digitization", "quality-control"
                        ]
                    },
                    "uniqueItems": true
                }
            }
        }
    },

[PonteIneptique]

ça me parait une super idée. Par contre, je tenterais peut-être un required sur name et type :)

[alix-tz]

ça marche !

[PonteIneptique]

Alors, en fait, je reviens sur la chose: on a un problème.

On force name, sauf que c'est plutôt surname la valeur obligatoire non pour les humains ?

Comment qu'on fait ?

[alix-tz]

Hm, en fait dans les contributeurs de CREMMA Wiki par exemple on a des personnes qui n'indiquent que leur prénom

[alix-tz]

Et ta proposition ne m'avait pas choquée parce que je me disais que dans le cas d'un pseudo, ça paraît plus instinctif de le mettre dans "name" plutôt que "surname"

edit: c'est complètement subjectif...

[PonteIneptique]

Bon, je vois pas comment gérer la chose:

1. Pas de required, mais c'est bizarre
2. Clé institutions vs. clé collaborators (mais dans le formulaire ça change rien, c'est "invisible" car on le gère en JS).
3. surname comme required.
4. name comme required.

[alix-tz]

Va pour l'option 2 !

[PonteIneptique]

Decision 17/06/2022: Option 2, clé "authors" and "institutions".