From ff1d55b0d41ade65f602d26f4e4e795bf531dc7e Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Sat, 13 Apr 2024 12:30:23 -0400
Subject: [PATCH] Makewording more explicit for _mod and remove MRI specificity
 of _acq (used in other modalities)

Relates to a discussion of _mod destiny in

https://github.com/bids-standard/bids-2-devel/issues/70
---
 src/schema/objects/entities.yaml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/schema/objects/entities.yaml b/src/schema/objects/entities.yaml
index 6facc34c0d..f15fab7e69 100644
--- a/src/schema/objects/entities.yaml
+++ b/src/schema/objects/entities.yaml
@@ -8,16 +8,16 @@ acquisition:
   display_name: Acquisition
   description: |
     The `acq-<label>` entity corresponds to a custom label the user MAY use to distinguish
-    a different set of parameters used for acquiring the same modality.
+    a different set of parameters used for acquiring the same kind of data.
 
-    For example, this should be used when a study includes two T1w images -
+    For example, this should be used when an MRI study includes two T1w images -
     one full brain low resolution and one restricted field of view but high resolution.
     In such case two files could have the following names:
     `sub-01_acq-highres_T1w.nii.gz` and `sub-01_acq-lowres_T1w.nii.gz`;
     however, the user is free to choose any other label than `highres` and `lowres` as long
     as they are consistent across subjects and sessions.
 
-    In case different sequences are used to record the same modality
+    In case different sequences are used to record the same MRI contrast
     (for example, `RARE` and `FLASH` for T1w)
     this field can also be used to make that distinction.
     The level of detail at which the distinction is made
@@ -154,9 +154,9 @@ label:
   format: label
 modality:
   name: mod
-  display_name: Corresponding Modality
+  display_name: Corresponding MRI Contrast
   description: |
-    The `mod-<label>` entity corresponds to modality label for defacing
+    The `mod-<label>` entity corresponds to the MRI contrast (in a loose terms - MRI modality) label for defacing
     masks, for example, T1w, inplaneT1, referenced by a defacemask image.
     For example, `sub-01_mod-T1w_defacemask.nii.gz`.
   type: string