brainlife / docs

Brainlife.io Documentation
https://brainlife.io/docs
10 stars 26 forks source link

Unintentional / potentially confusing use of term "datasets"? #85

Closed DanNBullock closed 2 years ago

DanNBullock commented 2 years ago

In the datatype tag subsection there is the following assertion:

You should only use this tag to specify the information on datasets, not generalize it.

(Bold added to highlight potential issue)

To my understanding "datasets" refers to entities like those listed on the datasets page. In this way, a dataset appears to primarily defined/delineated as a collection of data objects, typically instanced across subjects, and collectively bound by some combination of collection methodologies, subject characteristics, or project-level investigator intents.

However, the use here is a bit confusing, as it appears to blur the distinction between "datasets" and "datatypes" or "data objects". It seems to me that the appropriate term might be "datatypes", and the subsequent example provided (dwi datatype tags) seems consistent with this. I'm not 100% certain though, so I didn't want to unilaterally impose changes without inquiring with others about this first.

soichih commented 2 years ago

Yes, you are correct about "dataset". We should use "data object" rather than "dataset". I've updated the datatype page > https://brainlife.io/docs/user/datatypes/