From 5522e61f43e794eed52d1180f7079540b1e8073e Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Thu, 29 Aug 2024 13:50:17 -0400
Subject: [PATCH 1/3] Add human statement to emphasize that _desc is the last
 entity

Closes #1895
---
 src/derivatives/common-data-types.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/derivatives/common-data-types.md b/src/derivatives/common-data-types.md
index 035901811e..e2c45d2573 100644
--- a/src/derivatives/common-data-types.md
+++ b/src/derivatives/common-data-types.md
@@ -25,7 +25,7 @@ A guide for using macros can be found at
 Preprocessed `bold` NIfTI file in the original coordinate space of the original run.
 The location of the file in the original datasets is encoded in the `Sources` metadata,
 and [`_desc-<label>`](../appendices/entities.md#desc)
-is used to prevent clashing with the original filename.
+is used (the last entity before the suffix) to prevent clashing with the original filename.
 
 <!-- This block generates a file tree.
 A guide for using macros can be found at

From 83eafbc3cf00ddefb81d93a2769335c6a6b1598f Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Thu, 7 Aug 2025 15:03:20 -0400
Subject: [PATCH 2/3] Add a note to schema about description being the last

---
 src/schema/rules/entities.yaml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/schema/rules/entities.yaml b/src/schema/rules/entities.yaml
index 44174d333e..46ec29eb6f 100644
--- a/src/schema/rules/entities.yaml
+++ b/src/schema/rules/entities.yaml
@@ -31,4 +31,7 @@
 - resolution
 - density
 - label
+# NOTE: there is a current convention to keep description to be the last entity.
+# If to be changed - potentially might need to adjust text, e.g. now in
+# src/derivatives/common-data-types.md
 - description

From 4442a48b442b8d5b0ca2231a87cc23eb5b8199ef Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Fri, 22 Aug 2025 13:56:12 -0400
Subject: [PATCH 3/3] Avoid e.g. and point to this PR for more information

Co-authored-by: Chris Markiewicz <effigies@gmail.com>
---
 src/schema/rules/entities.yaml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/schema/rules/entities.yaml b/src/schema/rules/entities.yaml
index 46ec29eb6f..82850b34e7 100644
--- a/src/schema/rules/entities.yaml
+++ b/src/schema/rules/entities.yaml
@@ -32,6 +32,7 @@
 - density
 - label
 # NOTE: there is a current convention to keep description to be the last entity.
-# If to be changed - potentially might need to adjust text, e.g. now in
+# If to be changed - potentially might need to adjust text in
 # src/derivatives/common-data-types.md
+# See https://github.com/bids-standard/bids-specification/pull/1915
 - description