Review BCO property labeling

[ReneRanzinger]

Section A

I create a spreadsheet with the BCO properties that we will be using for the CSV based GlyGen data submission. It is based on Jeet's original table.

• Column A: JSON property name
• Column B: Jeets Description
• Column C: is that for people or software
• Column D: name of the role that we will present to the user

Section B

In general we have a few people/roles that can be involved in the dataset generation:

1. Person that conducted the experiment
2. Person that wrote the paper
3. Person that formatted the dataset using tablemaker
4. Person that submits the dataset to GlyGen

Section C

There are several types of software that can be involved in the dataset generation:

1. Instrument software (mass spec)
2. Data conversion software (msconvert)
3. Data interpretation software (GRITS)
4. Data formatting software (tablemaker, Excel)

Tasklist

Since a user/datagenerator will have to build the BCO string we want to present them with some human readable "Roles" that he can select for people and software.

@jeet-vora:

• [ ] I am not sure what the different is between "createdBy" and "authoredBy". Please clarify and provide Role names.
• [ ] Is the list in section A complete or based on section B and C are there rows that need to be added
• [ ] Section B: What role would 1-4 have or are some of them not part of the BCO
• [ ] Section C: What role would 1-4 have or are some of them not part of the BCO
• [ ] Are email and organization for people and software URL in the BCO mandatory?

@jeet-vora and @Mindyporterfield

• [ ] Are the names in column D good enough that they capture the "spirit" of the BCO property

[jeet-vora]

@ReneRanzinger

1. createdBy - The person who created the dataset by doing data processing (not curation) on the original data. The data could have been received originally from the author or the contributor. authoredBy - The person who originally generated the data as part of the research for submission or sharing.
2. The list in section A is so far complete. If we encounter other ucecases we can expand it.
3. Didn't understand Q3 and Q4 about role of 1-4. Please elaborate.
4. No email and organization for people and software URLs in the BCO are not mandatory but are important pieces of information for the documentation.
5. Yes column D names are good. Made minor additions

[ReneRanzinger]

@jeet-vora

1. So createdBy should be something like "Data Wrangler" while authoredBy is the actual "Data generator" that performed the experiment?
2. No sure how to say it differently. Section B lists the roles/people that are involved in make a dataset. Starting from the guy that performes the experiment to the the one that creates the CSV. Are all the people listed supposed to be in the BCO? Which of the BCO properties whould each of them get? It seems B.3 is "createdBy"? B1 and B2 is "authoredBy" or "contributedBy"? Not sure about B4. C is the same question for the software tools involved in making (in this case MS) dataset. Which of the software goes into the BCO and with which property?

[Mindyporterfield]

created vs contributed vs authored is very confusing , please explain why we need all these, we have the pmid so we have authors, authors did the experiments and contributed to the data. @jeet-vora @ReneRanzinger