Collect lists/taxonomies of contribution roles

CReDIT
AllContributors
Ted Habermann's preprint
R citation roles. Corresponding R Journal paper: https://journal.r-project.org/articles/RJ-2012-009/. They are based on MARC relator codes, but only a few are supported in practice - there are a few more than in the original R Journal article, see: https://ropensci.org/blog/2018/03/16/thanking-reviewers-in-metadata/. Note that the convention is for "authors" to be cited in formal references, so the other roles are more like acknowledgements (https://devguide.ropensci.org/collaboration.html?q=ctb#attributions)
SCoRO ontology
Policy on acknowledging the contribution of LLM/AI. An interesting talk on this here: https://poldrack.github.io/talks-AIAssistedCoding/talk/talk.html#/title-slide, which shows how LLMs might be used to write/refactor/review code or write tests. As the talk points out, there is some consensus on acknowledging LLM contribution on papers (https://poldrack.github.io/talks-AIAssistedCoding/talk/talk.html#/section-10, https://psyarxiv.com/b58ex), we should have similar for software. I've not seen any discussion on this yet, but probably others have thought of this already.

Linked to #2 so maybe we centralize everything in this issue and I close the other one

AllContributors (+)

Acknowledges non-code contributions
Automated

(-)

Does not include any information on versions: when does an author stop being an author, if ever?
Does not define a minimum contribution: a single commit would already count as author

R Contributors (+)

Stratification into "Objects" - defines a person by given name, family name, email
Roles clearly broken down in: author / compiler / contributor / copyright holder / creator / thesis advisor

(-)

In the Person definition - does not account for two family names (predominant in spanish-speaking countries) or other types of name organisation (no citation system does, but it would be nice)
Does not include authorships for project managers, designers...
Does not mention anything about different authorships in different versions
Only authors are actually cited downstream?

CRediT (+)

General groups - concise list instead of an infinite list of different contributors
General groups could be adapted specifically for software dev

(-)

Software is mentioned as a whole

ICMJE Guidelines (+)

Good paragraph on why authorship matters --> probably we should kind of have an statement of why authorship in software matters?
Includes what it means to be an author: accountability for scientific research is translatable to accountability for OS software?
Clear guideline: if you do not meet the 4 criteria, you are not considered an author

(-)

Very narrow definition of what an author is, rest are simply "acknowledged" - probably for OSS we want a more broad definition

Contributor Role Ontology expands and formalizes CrEdiT

Contributor Role Ontology terms are for all kind of roles for academic contributions and Open Research, but some of the specific terms apply well also to software (in bold):

acceptor role
acquisition role
advisory role
archivist role
author role
background and literature search role
code review role
collection role
community engagement role
community research partner
conceptualization role
conservator role
contributor role
coordination role
creator role
curator role
data collection role
data curation role
data entry role
data integration role
data modeling role
data quality assurance role
data role
data transformation role
data validation role
database administrator role
database role
device development role
digital preservation role
discovery role
documentation role
education and training role
educational training role
equipment technician role
evaluator role
figure development role
formal analysis role
funding acquisition role
funding source role
generically dependent continuant
grant peer review role
graphic design role
hardware role
infrastructure role
instruction role
instrumentation role
intellectual property role
investigation role
lay summary role
librarian role
marketing and communication role
metadata role
methodology role
modifier role
original draft preparation role
outreach materials development role
patient advocate role
peer review role
policy development role
presenter role
preservation role
primary collector role
project administration role
project management role
project, policy or program evaluation role
protocol creation role
regulatory and compliance role
requirements analysis role
research conceptualization role
resources role
software architecture role
software design role
software engineering role
software role
software testing role
specimen collection role
standards development role
standards role
statistical analysis role
study design role
submitter role
supervision role
supervisory role
survey and questionnaire development role
system administrator role
systems administration role
team management role
technical documentation role
technical writing role
technician role
technique development role
training material role
training program development role
translator role
validation role
visualization role
website role
writing original draft role
writing review and editing role

Some of the obsoluted terms may be relevant but may already be covered above:

obsolete IT hardware systems design and implementation role
obsolete computer programming role
obsolete data aggregation role
obsolete data standards developer role
obsolete information technology systems role
obsolete marketing role
obsolete networking facilitation role
obsolete participant recruitment role
obsolete program administration role
obsolete software systems role
obsolete standard operating procedure development role
obsolete website maintenance role

These are also organized in a hierarchy (e.g. "technician role" is a subtype of "investigation role") from CrEDiT

Contributor Role Ontology terms are for all kind of roles for academic contributions and Open Research, but some of the specific terms apply well also to software (in bold):

acceptor role

acquisition role

advisory role

archivist role

author role

background and literature search role

code review role

collection role

community engagement role

community research partner

conceptualization role

conservator role

continuant

contributor role

contributorship

coordination role

creator role

curation status specification

curator role

data about an ontology part

data collection role

data curation role

data entry role

data integration role

data item

data modeling role

data quality assurance role

data role

data transformation role

data validation role

database administrator role

database role

denotator type

device development role

digital preservation role

discovery role

documentation role

education and training role

educational training role

entity

equipment technician role

evaluator role

figure development role

formal analysis role

funding acquisition role

funding source role

generically dependent continuant

grant peer review role

graphic design role

hardware role

information content entity

infrastructure role

instruction role

instrumentation role

intellectual property role

investigation role

lay summary role

librarian role

marketing and communication role

metadata role

methodology role

modifier role

original draft preparation role

outreach materials development role

patient advocate role

peer review role

policy development role

presenter role

preservation role

primary collector role

project administration role

project management role

project, policy or program evaluation role

protocol creation role

regulatory and compliance role

relationship

requirements analysis role

research conceptualization role

resources role

software architecture role

software design role

software engineering role

software role

software testing role

specifically dependent continuant

specimen collection role

standards development role

standards role

statistical analysis role

study design role

submitter role

supervision role

supervisory role

survey and questionnaire development role

system administrator role

systems administration role

team management role

technical documentation role

technical writing role

technician role

technique development role

training material role

training program development role

translator role

validation role

visualization role

website role

writing original draft role

writing review and editing role

Some of the obsoluted terms may be relevant:

obsolescence reason specification

obsolete IT hardware systems design and implementation role

obsolete computer programming role

obsolete data aggregation role

obsolete data standards developer role

obsolete information technology systems role

obsolete marketing role

obsolete networking facilitation role

obsolete participant recruitment role

obsolete program administration role

obsolete software systems role

obsolete standard operating procedure development role

obsolete website maintenance role

These are also organized in a hierarchy (e.g. "technician role" is a subtype of "investigation role") from CrEDiT

I like the Obsolete or another terminology for maybe tackling the issue of authorship in versions?

Related roles highoighted from SCoRO ontology:

access provider
accountant
administrator
affiliate
agent
analyses data
approves final manuscript
article guarantor
auditor
builds and/or maintains instruments
CEO
chief scientist
claimant
co-applicant
co-investigator
collaborator
collects data
college fellow
college head
computer programmer
conceives project
consortium author
consultant
contact person
contractor
contributed all the effort
contributed major effort
contributed minor effort
controls project finances
corresponding author
creates novel organisms or cells
creates novel reagents
creates software
CTO
curator
data creator
data curator
data manager
data publisher
data user
departmental administrator
designs experiments
develops methodology
director
doctoral student
embargo controller
employee
employer
ensures regulatory compliance
faculty member
financial controller
formulates research questions
funder
funding recipient
head of department
host institution
illustrator
interprets results
inventor
lead applicant
leads investigation
maintains IT infrastructure
maintains organisms or cell cultures
maintains research facility
manager
manages project
master student
member
non-academic staff member
obtains and/or prepared specimens
organizer
owner
participant
partner
patent holder
performs experiments
photographer
possessor
postdoctoral researcher
postgraduate student
prepares illustrations
prepares supplementary information
principal author
principal investigator
processs data
programme manager
project leader
project manager
project member
project student
provided service
provides administrative support
provides advice
provides existing data
provides patients
provides reagents, specimens or materials
provides software
provides technical support
provides tools, equipment or facilities
publishes data
purchaser
registrar
registration agency
registration authority
repository manager
research assistant
research student
researcher
revises manuscript
rights holder
scholar
secures funding
senior author
service engineer
spokesperson
sponsor
stakeholder
sub-contractor
successor
Supervises, mentors or trains colleagues
supervisor
supplier
technician
undergraduate student
undertakes modelling
vice-chancellor
web-master
workpackage leader
writes manuscript draft

"Ted Habermann's preprint" is https://doi.org/10.5281/zenodo.4767798 -- @Bisaloo is trying to pull out the table as a CSV.

We could try to merge in the bold items into that updated table and then we need to select like 10-15 terms only so we can have a managable/understandable list

Zenodo's docs give:

ContactPerson
DataCollector
DataCurator
DataManager
Distributor
Editor,
HostingInstitution
Producer
ProjectLeader
ProjectManager
ProjectMember
RegistrationAgency
RegistrationAuthority
RelatedPerson
Researcher
ResearchGroup
RightsHolder
Supervisor
Sponsor
WorkPackageLeader
Other

researchsoft / software-authorship-contribution

Collect lists/taxonomies of contribution roles #5