From 82674bca3a7f299116926ec9ffbb4a1b7f8a4d79 Mon Sep 17 00:00:00 2001
From: Stefan Appelhoff <stefan.appelhoff@mailbox.org>
Date: Thu, 6 Jun 2024 09:28:40 +0200
Subject: [PATCH 01/18] add deprecation check

---
 src/schema/rules/checks/deprecations.yml | 53 ++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 src/schema/rules/checks/deprecations.yml

diff --git a/src/schema/rules/checks/deprecations.yml b/src/schema/rules/checks/deprecations.yml
new file mode 100644
index 0000000000..d7a3c27372
--- /dev/null
+++ b/src/schema/rules/checks/deprecations.yml
@@ -0,0 +1,53 @@
+AnatomicalLandmarkCoordinateSystemDeprecation:
+  issue:
+    code: ELEKTA_NEUROMAG_DEPRECATED
+    message: |
+        "ElektaNeuromag" as a coordinate system is deprecated.
+        Use "NeuromagElektaMEGIN" instead.
+    level: warning
+  selectors:
+    - sidecar.AnatomicalLandmarkCoordinateSystem
+  checks:
+    - sidecar.AnatomicalLandmarkCoordinateSystem != "ElektaNeuromag"
+
+DigitizedHeadPointsCoordinateSystemDeprecation:
+  $ref: rules.checks.deprecations.AnatomicalLandmarkCoordinateSystemDeprecation
+  selectors:
+    - sidecar.DigitizedHeadPointsCoordinateSystem
+  checks:
+    - sidecar.DigitizedHeadPointsCoordinateSystem != "ElektaNeuromag"
+
+EEGCoordinateSystemDeprecation:
+  $ref: rules.checks.deprecations.AnatomicalLandmarkCoordinateSystemDeprecation
+  selectors:
+    - sidecar.EEGCoordinateSystem
+  checks:
+    - sidecar.EEGCoordinateSystem != "ElektaNeuromag"
+
+FiducialsCoordinateSystemDeprecation:
+  $ref: rules.checks.deprecations.AnatomicalLandmarkCoordinateSystemDeprecation
+  selectors:
+    - sidecar.FiducialsCoordinateSystem
+  checks:
+    - sidecar.FiducialsCoordinateSystem != "ElektaNeuromag"
+
+HeadCoilCoordinateSystemDeprecation:
+  $ref: rules.checks.deprecations.AnatomicalLandmarkCoordinateSystemDeprecation
+  selectors:
+    - sidecar.HeadCoilCoordinateSystem
+  checks:
+    - sidecar.HeadCoilCoordinateSystem != "ElektaNeuromag"
+
+MEGCoordinateSystemDeprecation:
+  $ref: rules.checks.deprecations.AnatomicalLandmarkCoordinateSystemDeprecation
+  selectors:
+    - sidecar.MEGCoordinateSystem
+  checks:
+    - sidecar.MEGCoordinateSystem != "ElektaNeuromag"
+
+NIRSCoordinateSystemDeprecation:
+  $ref: rules.checks.deprecations.AnatomicalLandmarkCoordinateSystemDeprecation
+  selectors:
+    - sidecar.NIRSCoordinateSystem
+  checks:
+    - sidecar.NIRSCoordinateSystem != "ElektaNeuromag"

From 2f933e8ae9ba61a8277a7c22990784a1395b7f29 Mon Sep 17 00:00:00 2001
From: Stefan Appelhoff <stefan.appelhoff@mailbox.org>
Date: Thu, 6 Jun 2024 14:19:27 +0200
Subject: [PATCH 02/18] [FIX] Consistently refer to Neuromag/Elekta/MEGIN
 (#1310)

* DRAFT: consistently refer to Neuromag/Elekta/MEGIN

* add deprecation notices

* add links to deprecation
---
 src/appendices/coordinate-systems.md |  5 +++--
 src/schema/objects/enums.yaml        | 10 +++++++++-
 src/schema/rules/sidecars/meg.yaml   |  5 ++++-
 3 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/src/appendices/coordinate-systems.md b/src/appendices/coordinate-systems.md
index c5b44207bc..c3312a3e70 100644
--- a/src/appendices/coordinate-systems.md
+++ b/src/appendices/coordinate-systems.md
@@ -108,11 +108,12 @@ Restricted keywords for the `<CoordSysType>CoordinateSystem` field in the
 `coordinatesystem.json` file for MEG datasets:
 
 -   `CTF`: ALS orientation and the origin between the ears
--   `ElektaNeuromag`: RAS orientation and the origin between the ears
+-   `NeuromagElektaMEGIN`: RAS orientation and the origin between the ears
 -   `4DBti`: ALS orientation and the origin between the ears
 -   `KitYokogawa`: ALS orientation and the origin between the ears
 -   `ChietiItab`: RAS orientation and the origin between the ears
 -   Any keyword from the list of [Standard template identifiers](#standard-template-identifiers): RAS orientation and the origin at the center of the gradient coil for template NifTI images
+-   The use of `ElektaNeuromag` is [DEPRECATED][deprecated]. Dataset curators SHOULD use `NeuromagElektaMEGIN` instead.
 
 In the case that MEG was recorded simultaneously with EEG,
 the restricted keywords for
@@ -146,7 +147,7 @@ the restricted keywords for
 can also be applied to EEG:
 
 -   `CTF`
--   `ElektaNeuromag`
+-   `NeuromagElektaMEGIN`
 -   `4DBti`
 -   `KitYokogawa`
 -   `ChietiItab`
diff --git a/src/schema/objects/enums.yaml b/src/schema/objects/enums.yaml
index f01d16cdc6..2f63006460 100644
--- a/src/schema/objects/enums.yaml
+++ b/src/schema/objects/enums.yaml
@@ -20,7 +20,8 @@ _MEGCoordSys:
   type: string
   enum:
     - $ref: objects.enums.CTF.value
-    - $ref: objects.enums.ElektaNeuromag.value
+    - $ref: objects.enums.ElektaNeuromag.value # deprecated
+    - $ref: objects.enums.NeuromagElektaMEGIN.value
     - $ref: objects.enums.4DBti.value
     - $ref: objects.enums.KitYokogawa.value
     - $ref: objects.enums.ChietiItab.value
@@ -305,6 +306,13 @@ CTF:
 ElektaNeuromag:
   value: ElektaNeuromag
   display_name: Elekta Neuromag
+  description: |
+    RAS orientation and the origin between the ears.
+    [DEPRECATED](SPEC_ROOT/common-principles.md#definitions).
+    Dataset curators SHOULD use `NeuromagElektaMEGIN` instead.
+NeuromagElektaMEGIN:
+  value: NeuromagElektaMEGIN
+  display_name: Neuromag Elekta MEGIN
   description: |
     RAS orientation and the origin between the ears.
 4DBti:
diff --git a/src/schema/rules/sidecars/meg.yaml b/src/schema/rules/sidecars/meg.yaml
index a989d40f9f..33d851f6af 100644
--- a/src/schema/rules/sidecars/meg.yaml
+++ b/src/schema/rules/sidecars/meg.yaml
@@ -20,8 +20,11 @@ MEGHardware:
       level: recommended
       description_addendum: |
         For MEG scanners, this must be one of:
-        `"CTF"`, `"Elekta/Neuromag"`, `"BTi/4D"`, `"KIT/Yokogawa"`,
+        `"CTF"`, `"Neuromag/Elekta/MEGIN"`, `"BTi/4D"`, `"KIT/Yokogawa"`,
         `"ITAB"`, `"KRISS"`, `"Other"`.
+        The use of `"Elekta/Neuromag"` is
+        [DEPRECATED](SPEC_ROOT/common-principles.md#definitions).
+        Dataset curators SHOULD use `"Neuromag/Elekta/MEGIN"` instead.
         See the [MEG Systems Appendix](SPEC_ROOT/appendices/meg-systems.md) for
         preferred names.
     ManufacturersModelName:

From 4259163bc92b7da7771be8e8ded9cdc66d910ae0 Mon Sep 17 00:00:00 2001
From: Stefan Appelhoff <stefan.appelhoff@mailbox.org>
Date: Fri, 7 Jun 2024 11:45:34 +0200
Subject: [PATCH 03/18] Update requirements.txt

---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 25f0520a6a..81609f6b67 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,4 +1,4 @@
-mkdocs>=1.1
+mkdocs>=1.1.0
 mkdocs-material>=5.4
 pymdown-extensions>=7.0.0
 mkdocs-branchcustomization-plugin~=0.1.3

From eba3e08e2dbfd3ad2e57c2a52c3bda8c1961dc6c Mon Sep 17 00:00:00 2001
From: Stefan Appelhoff <stefan.appelhoff@mailbox.org>
Date: Fri, 7 Jun 2024 12:38:19 +0200
Subject: [PATCH 04/18] fix changelog generation [build changelog]

xref: https://github.com/bids-standard/bids-specification/pull/1850
---
 .github/workflows/changelog_generator.yml | 36 +++++++++++++----------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/.github/workflows/changelog_generator.yml b/.github/workflows/changelog_generator.yml
index 45d9948d32..7e0291b542 100644
--- a/.github/workflows/changelog_generator.yml
+++ b/.github/workflows/changelog_generator.yml
@@ -101,10 +101,11 @@ jobs:
 
     commit_generated_changelog:
         permissions:
-            # Give the default GITHUB_TOKEN write permission to commit and push the
-            # added or changed files to the repository.
             contents: write
+            pull-requests: write
         needs: lint_generated_changelog
+        # Run only if the head commit message contains "[build changelog]""
+        if: contains(github.event.head_commit.message, '[build changelog]')
         runs-on: ubuntu-latest
         steps:
         - uses: actions/checkout@v4
@@ -113,18 +114,21 @@ jobs:
           with:
             name: changelog_post_lint
             path: ~/changelog_build
-        - name: Changelog deployment
+        - name: add changelog to git
           run: |
-            if (git log -1 --pretty=%s | grep Merge*) && (! git log -1 --pretty=%b | grep REL:) ; then
-              mv ~/changelog_build/CHANGES.md ${{ github.workspace }}/src/CHANGES.md
-              merge_message=$(git log -1 | grep Merge | grep "pull")
-              PR_number=$(echo $merge_message | cut -d ' ' -f 4)
-              git config credential.helper 'cache --timeout=120'
-              git config user.email "bids.maintenance@gmail.com"
-              git config user.name "bids-maintenance"
-              git add ${{ github.workspace }}/src/CHANGES.md
-              git commit -m "[DOC] Auto-generate changelog entry for PR ${PR_number}"
-              git push https://${{ secrets.GITHUB_TOKEN }}@github.com/bids-standard/bids-specification.git master
-            else
-              echo "Did not detect a "Merge commit" to master, or detected a Release ... doing nothing."
-            fi
+            mv ~/changelog_build/CHANGES.md ${{ github.workspace }}/src/CHANGES.md
+            git config credential.helper 'cache --timeout=120'
+            git config user.email "bids.maintenance@gmail.com"
+            git config user.name "bids-maintenance"
+            git add ${{ github.workspace }}/src/CHANGES.md
+            git commit -m "[DOC] Auto-generated changelog entry"
+        - name: Create Pull Request
+          uses: peter-evans/create-pull-request@v6
+          with:
+            token: ${{ secrets.GITHUB_TOKEN }}
+            branch: changelog_generator_update
+            delete-branch: true
+            title: '[DOC] Auto-generated changelog entry'
+            labels: |
+              exclude-from-changelog
+            draft: false

From b0cfe7b7bc7fc065cb8ab023cf0f60dd6ed3ce92 Mon Sep 17 00:00:00 2001
From: Chris Markiewicz <effigies@gmail.com>
Date: Sun, 9 Jun 2024 22:28:29 -0400
Subject: [PATCH 05/18] schema: Add regression test to expression tests

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

diff --git a/src/schema/meta/expression_tests.yaml b/src/schema/meta/expression_tests.yaml
index 5ebb7dcec0..8ab60a28d4 100644
--- a/src/schema/meta/expression_tests.yaml
+++ b/src/schema/meta/expression_tests.yaml
@@ -112,6 +112,9 @@
   result: [1, 2, 3]
 - expression: allequal(sorted([3, 2, 1]), [1, 2, 3])
   result: true
+# Regression test. Javascript will sort lexically by default.
+- expression: sorted([9, 81, 729, 6561])
+  result: [9, 81, 729, 6561]
 - expression: min([-1, "n/a", 1])
   result: -1
 - expression: max([-1, "n/a", 1])

From a98153595e9ae653c4f87c5b6781e05291afbd37 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 13 Jun 2024 19:28:27 +0200
Subject: [PATCH 06/18] [DOC] Auto-generated changelog entry (#1852)

Co-authored-by: bids-maintenance <bids.maintenance@gmail.com>
---
 src/CHANGES.md | 145 ++++++++++++++++++++++++++++++++++---------------
 1 file changed, 102 insertions(+), 43 deletions(-)

diff --git a/src/CHANGES.md b/src/CHANGES.md
index 087368ffea..106f7e1aa0 100644
--- a/src/CHANGES.md
+++ b/src/CHANGES.md
@@ -1,15 +1,50 @@
 # Changelog
 
+## [Unreleased](https://github.com/bids-standard/bids-specification/tree/HEAD)
+
+-   \[ENH] Add use of session entity as example of encoding multi-site studies in a single dataset [#1803](https://github.com/bids-standard/bids-specification/pull/1803) ([yarikoptic](https://github.com/yarikoptic))
+-   \[ENH] Describe Inheritance Principle in Common Principles [#1807](https://github.com/bids-standard/bids-specification/pull/1807) ([Lestropie](https://github.com/Lestropie))
+-   \[ENH] Use deidentification consistently in place of anonymization [#1799](https://github.com/bids-standard/bids-specification/pull/1799) ([DimitriPapadopoulos](https://github.com/DimitriPapadopoulos))
+-   \[INFRA] Introduce metaschema [#1787](https://github.com/bids-standard/bids-specification/pull/1787) ([bendichter](https://github.com/bendichter))
+-   \[ENH] Add warning about deidentification when sharing sourcedata [#1769](https://github.com/bids-standard/bids-specification/pull/1769) ([Remi-Gau](https://github.com/Remi-Gau))
+-   ENH: Use "Tag XXXX, YYYY" not "Tag (XXXX,YYYY)" for DICOM Tags [#1758](https://github.com/bids-standard/bids-specification/pull/1758) ([yarikoptic](https://github.com/yarikoptic))
+-   \[ENH]\[SCHEMA] Allow .bval and .bvec files for pepolar fmaps [#1754](https://github.com/bids-standard/bids-specification/pull/1754) ([mattcieslak](https://github.com/mattcieslak))
+-   FIX: Move `\_stim.\<ext\>` specification within the Task Events module [#1750](https://github.com/bids-standard/bids-specification/pull/1750) ([oesteban](https://github.com/oesteban))
+-   ENH: Add compressed TSV files to the common principles [#1749](https://github.com/bids-standard/bids-specification/pull/1749) ([oesteban](https://github.com/oesteban))
+-   \[MAINT] split physio metadata tables [#1746](https://github.com/bids-standard/bids-specification/pull/1746) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[FIX] Move `rawdata/` into `sourcedata/raw` in alternative structure example, clarify on naming of datasets themselves [#1741](https://github.com/bids-standard/bids-specification/pull/1741) ([yarikoptic](https://github.com/yarikoptic))
+-   \[FIX] Remove mentions of sourcedata in the datatype specific pages [#1737](https://github.com/bids-standard/bids-specification/pull/1737) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[ENH] events.tsv should be sorted by onset values [#1732](https://github.com/bids-standard/bids-specification/pull/1732) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[FIX] fix typo  in motion.md [#1731](https://github.com/bids-standard/bids-specification/pull/1731) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[ENH] Specify the naming of scanner-generated TRACE and ADC volumes [#1725](https://github.com/bids-standard/bids-specification/pull/1725) ([effigies](https://github.com/effigies))
+-   FIX: Re-add run entity to electrodes.tsv [#1722](https://github.com/bids-standard/bids-specification/pull/1722) ([effigies](https://github.com/effigies))
+-   \[FIX] Add misssing files in filename template for NIRS [#1716](https://github.com/bids-standard/bids-specification/pull/1716) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[FIX] Missing word in `genetic-descriptor.md` [#1715](https://github.com/bids-standard/bids-specification/pull/1715) ([markmikkelsen](https://github.com/markmikkelsen))
+-   Add `descriptions.tsv` to the schema [#1707](https://github.com/bids-standard/bids-specification/pull/1707) ([tsalo](https://github.com/tsalo))
+-   \[FIX] Remove task entity from DWI and PERF time series file templates [#1703](https://github.com/bids-standard/bids-specification/pull/1703) ([Remi-Gau](https://github.com/Remi-Gau))
+-   ENH: Clarify the relation of motion.tsv columns to channels.tsv rows [#1699](https://github.com/bids-standard/bids-specification/pull/1699) ([effigies](https://github.com/effigies))
+-   \[STY] apply black 24.1.0 [#1688](https://github.com/bids-standard/bids-specification/pull/1688) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[ENH] Describe parametric images above the suffix table, rather than below [#1687](https://github.com/bids-standard/bids-specification/pull/1687) ([CPernet](https://github.com/CPernet))
+-   \[ENH] Add support for HiP-CT [#1686](https://github.com/bids-standard/bids-specification/pull/1686) ([balbasty](https://github.com/balbasty))
+-   \[FIX] Add `part-<value>` to the PEPOLAR fieldmaps [#1685](https://github.com/bids-standard/bids-specification/pull/1685) ([oesteban](https://github.com/oesteban))
+-   \[MISC] Restructure MEG empty room example texts [#1677](https://github.com/bids-standard/bids-specification/pull/1677) ([guiomar](https://github.com/guiomar))
+-   ENH: Add sample metadata to MRI and PET [#1593](https://github.com/bids-standard/bids-specification/pull/1593) ([effigies](https://github.com/effigies))
+-   \[ENH] Add noRF suffix for MR excitation-free noise scans [#1451](https://github.com/bids-standard/bids-specification/pull/1451) ([tsalo](https://github.com/tsalo))
+-   \[ENH] Add generic metadata from BEP22 to MRI [#1396](https://github.com/bids-standard/bids-specification/pull/1396) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[FIX] Consistently refer to Neuromag/Elekta/MEGIN [#1310](https://github.com/bids-standard/bids-specification/pull/1310) ([sappelhoff](https://github.com/sappelhoff))
+
 ## [v1.9.0](https://github.com/bids-standard/bids-specification/tree/v1.9.0) (2023-11-20)
 
+-   \[ENH] Add `descriptions.tsv` file relating to the `desc-<label>` entity [#1613](https://github.com/bids-standard/bids-specification/pull/1613) ([CPernet](https://github.com/CPernet))
+-   \[INFRA] Publish schema tools API docs to additional ReadTheDocs site [#1491](https://github.com/bids-standard/bids-specification/pull/1491) ([bendhouseart](https://github.com/bendhouseart))
+-   \[ENH] Extend BIDS for Motion data (BEP029) [#981](https://github.com/bids-standard/bids-specification/pull/981) ([JuliusWelzel](https://github.com/JuliusWelzel))
 -   \[FIX] mention phenotype dir in folder structure [#1644](https://github.com/bids-standard/bids-specification/pull/1644) ([Remi-Gau](https://github.com/Remi-Gau))
--   \[ENH] add `ElectricalStimulation` and `\*Parameters` metadata to MEEG jsons [#1638](https://github.com/bids-standard/bids-specification/pull/1638) ([sappelhoff](https://github.com/sappelhoff))
+-   \[ENH] add `ElectricalStimulation` and `*Parameters` metadata to MEEG jsons [#1638](https://github.com/bids-standard/bids-specification/pull/1638) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] years and degrees Units and unit to be singular to match the rest [#1631](https://github.com/bids-standard/bids-specification/pull/1631) ([yarikoptic](https://github.com/yarikoptic))
 -   \[FIX] Hierarchical Event Descriptors (HED) page update [#1623](https://github.com/bids-standard/bids-specification/pull/1623) ([effigies](https://github.com/effigies))
--   \[ENH] Add `descriptions.tsv` file relating to the `desc-\<label\>` entity [#1613](https://github.com/bids-standard/bids-specification/pull/1613) ([CPernet](https://github.com/CPernet))
 -   \[FIX] Do not require notch frequencies to be parsed as numbers, accommodating multiples [#1605](https://github.com/bids-standard/bids-specification/pull/1605) ([effigies](https://github.com/effigies))
 -   \[ENH] Allow Levels field of column descriptions to be objects with TermURLs for each level [#1603](https://github.com/bids-standard/bids-specification/pull/1603) ([Remi-Gau](https://github.com/Remi-Gau))
--   \[ENH] Add optional low_cutoff and high_cutoff columns for fnirs channels.tsv [#1597](https://github.com/bids-standard/bids-specification/pull/1597) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[ENH] Add optional low\_cutoff and high\_cutoff columns for fnirs channels.tsv [#1597](https://github.com/bids-standard/bids-specification/pull/1597) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[FIX] Recommend SliceTiming if MRAcquisitionType is "2D" [#1594](https://github.com/bids-standard/bids-specification/pull/1594) ([tsalo](https://github.com/tsalo))
 -   \[ENH] Add Level objects to channels.json for motion [#1591](https://github.com/bids-standard/bids-specification/pull/1591) ([effigies](https://github.com/effigies))
 -   \[ENH] Add "chunk" entity to MRI datatype [#1586](https://github.com/bids-standard/bids-specification/pull/1586) ([valosekj](https://github.com/valosekj))
@@ -27,24 +62,23 @@
 -   \[ENH] Clarify meaning of raw vs derivative datasets [#1537](https://github.com/bids-standard/bids-specification/pull/1537) ([CPernet](https://github.com/CPernet))
 -   \[FIX] match subject label in folder and filename in func example [#1536](https://github.com/bids-standard/bids-specification/pull/1536) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[FIX] Trail MEG directory formats with `/` [#1534](https://github.com/bids-standard/bids-specification/pull/1534) ([effigies](https://github.com/effigies))
--   \[ENH] Permit CITATION.cff as structured alternative to some dataset_description fields [#1525](https://github.com/bids-standard/bids-specification/pull/1525) ([effigies](https://github.com/effigies))
+-   \[ENH] Permit CITATION.cff as structured alternative to some dataset\_description fields [#1525](https://github.com/bids-standard/bids-specification/pull/1525) ([effigies](https://github.com/effigies))
 -   \[FIX] Add missing column description in physio example [#1514](https://github.com/bids-standard/bids-specification/pull/1514) ([sappelhoff](https://github.com/sappelhoff))
 -   \[ENH] Clarify that data files must be uniquely identified by entities/suffix [#1508](https://github.com/bids-standard/bids-specification/pull/1508) ([sappelhoff](https://github.com/sappelhoff))
--   \[INFRA] Publish schema tools API docs to additional ReadTheDocs site [#1491](https://github.com/bids-standard/bids-specification/pull/1491) ([bendhouseart](https://github.com/bendhouseart))
 -   \[FIX] Remove references to unspecified aslcontext.json [#1485](https://github.com/bids-standard/bids-specification/pull/1485) ([Remi-Gau](https://github.com/Remi-Gau))
 -   ENH: Define channel column for events and Delimiter field for column descriptions [#1483](https://github.com/bids-standard/bids-specification/pull/1483) ([effigies](https://github.com/effigies))
 -   \[FIX] Revert index (entity format) definition to be a non-negative number, permitting zero [#1482](https://github.com/bids-standard/bids-specification/pull/1482) ([TheChymera](https://github.com/TheChymera))
 -   \[FIX] Clean up qMRI RB1COR notes [#1465](https://github.com/bids-standard/bids-specification/pull/1465) ([lukeje](https://github.com/lukeje))
 -   \[ENH] Allow fractional seconds in StartTime [#1459](https://github.com/bids-standard/bids-specification/pull/1459) ([sappelhoff](https://github.com/sappelhoff))
--   \[MISC] consistently list filename templates; `ext` --> `extension`; `\_photo.jpg` --> `\_photo.\<extension\>` [#1458](https://github.com/bids-standard/bids-specification/pull/1458) ([sappelhoff](https://github.com/sappelhoff))
+-   \[MISC] consistently list filename templates; `ext` --> `extension`; `_photo.jpg` --> `_photo.<extension>` [#1458](https://github.com/bids-standard/bids-specification/pull/1458) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Demote `sample` and `value` columns in `events.tsv` from OPTIONAL to arbitrary [#1457](https://github.com/bids-standard/bids-specification/pull/1457) ([sappelhoff](https://github.com/sappelhoff))
 -   \[ENH] Clarify shape of PDT2 images and recommend acq entity for split PDw/T2w images [#1448](https://github.com/bids-standard/bids-specification/pull/1448) ([effigies](https://github.com/effigies))
 -   \[ENH] clarify guiding principles for requirement levels [#1444](https://github.com/bids-standard/bids-specification/pull/1444) ([sappelhoff](https://github.com/sappelhoff))
--   \[FIX] Clarify that dataset_description.Genetics object is required for genetics data [#1442](https://github.com/bids-standard/bids-specification/pull/1442) ([sappelhoff](https://github.com/sappelhoff))
+-   \[FIX] Clarify that dataset\_description.Genetics object is required for genetics data [#1442](https://github.com/bids-standard/bids-specification/pull/1442) ([sappelhoff](https://github.com/sappelhoff))
 -   \[ENH] Clarify that BIDS specification is in American English [#1439](https://github.com/bids-standard/bids-specification/pull/1439) ([yarikoptic](https://github.com/yarikoptic))
 -   \[MISC] Link to new BEP guidelines. [#1426](https://github.com/bids-standard/bids-specification/pull/1426) ([arokem](https://github.com/arokem))
 -   \[FIX] reorganize anat filename templates [#1419](https://github.com/bids-standard/bids-specification/pull/1419) ([Remi-Gau](https://github.com/Remi-Gau))
--   \[FIX] Rename `channels.tsv` column: `orientation\_component` to `component` [#1417](https://github.com/bids-standard/bids-specification/pull/1417) ([sjeung](https://github.com/sjeung))
+-   \[FIX] Rename `channels.tsv` column: `orientation_component` to `component` [#1417](https://github.com/bids-standard/bids-specification/pull/1417) ([sjeung](https://github.com/sjeung))
 -   \[ENH] Some missing docstrings for bidsschematools [#1413](https://github.com/bids-standard/bids-specification/pull/1413) ([anibalsolon](https://github.com/anibalsolon))
 -   \[FIX] fixing some minor issues introduced recently [#1411](https://github.com/bids-standard/bids-specification/pull/1411) ([yarikoptic](https://github.com/yarikoptic))
 -   \[ENH] Add paragraph about richness versus distinctness in filenames [#1392](https://github.com/bids-standard/bids-specification/pull/1392) ([CPernet](https://github.com/CPernet))
@@ -62,13 +96,14 @@
 -   \[ENH] Add qMRI fieldmap filename templates [#1336](https://github.com/bids-standard/bids-specification/pull/1336) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[ENH] Introduce GIFTI formats in derivatives [#1333](https://github.com/bids-standard/bids-specification/pull/1333) ([effigies](https://github.com/effigies))
 -   \[ENH] Add ParallelReductionFactorOutOfPlane to MRI metadata [#1221](https://github.com/bids-standard/bids-specification/pull/1221) ([lukeje](https://github.com/lukeje))
--   \[ENH]\[SCHEMA] Adding an OPTIONAL `\_task-\<label\>` to structural MRI acquisitions [#1185](https://github.com/bids-standard/bids-specification/pull/1185) ([melanieganz](https://github.com/melanieganz))
+-   \[ENH]\[SCHEMA] Adding an OPTIONAL `_task-<label>` to structural MRI acquisitions [#1185](https://github.com/bids-standard/bids-specification/pull/1185) ([melanieganz](https://github.com/melanieganz))
 -   \[INFRA] use tributors to list contributors and CITATION.cff for referencing [#1115](https://github.com/bids-standard/bids-specification/pull/1115) ([Remi-Gau](https://github.com/Remi-Gau))
--   \[ENH] Extend BIDS for Motion data (BEP029) [#981](https://github.com/bids-standard/bids-specification/pull/981) ([JuliusWelzel](https://github.com/JuliusWelzel))
 -   \[SCHEMA] Add full object definitions for valid values in schema [#919](https://github.com/bids-standard/bids-specification/pull/919) ([tsalo](https://github.com/tsalo))
 
 ## [v1.8.0](https://github.com/bids-standard/bids-specification/tree/v1.8.0) (2022-10-29)
 
+-   \[ENH] allow for .png and .tif in eeg/ieeg/meg as allowed for micr [#1049](https://github.com/bids-standard/bids-specification/pull/1049) ([yarikoptic](https://github.com/yarikoptic))
+-   \[ENH] Add BIDS URIs and deprecate relative paths, RawSources and (possibly unused) BasedOn [#918](https://github.com/bids-standard/bids-specification/pull/918) ([effigies](https://github.com/effigies))
 -   \[FIX] Drop the functional and f for NIRS [#1325](https://github.com/bids-standard/bids-specification/pull/1325) ([rob-luke](https://github.com/rob-luke))
 -   \[FIX]\[SCHEMA] Add conditionals for PET ReconMethod\* and ReconFilter [#1299](https://github.com/bids-standard/bids-specification/pull/1299) ([bendhouseart](https://github.com/bendhouseart))
 -   \[ENH] use schema to mention which "top directories" are allowed [#1289](https://github.com/bids-standard/bids-specification/pull/1289) ([Remi-Gau](https://github.com/Remi-Gau))
@@ -92,36 +127,50 @@
 -   \[ENH] Add Microscopy-BIDS citation [#1102](https://github.com/bids-standard/bids-specification/pull/1102) ([mariehbourget](https://github.com/mariehbourget))
 -   \[FIX] MEG link typo [#1100](https://github.com/bids-standard/bids-specification/pull/1100) ([xi](https://github.com/xi))
 -   \[FIX] IntendedFor in (i)EEG is dataset relative [#1093](https://github.com/bids-standard/bids-specification/pull/1093) ([sappelhoff](https://github.com/sappelhoff))
--   \[MISC] make dataset_description.Authors RECOMMENDED [#1092](https://github.com/bids-standard/bids-specification/pull/1092) ([sappelhoff](https://github.com/sappelhoff))
+-   \[MISC] make dataset\_description.Authors RECOMMENDED [#1092](https://github.com/bids-standard/bids-specification/pull/1092) ([sappelhoff](https://github.com/sappelhoff))
 -   \[ENH] adding optional \_rec-label to DWI [#1090](https://github.com/bids-standard/bids-specification/pull/1090) ([dorahermes](https://github.com/dorahermes))
+-   \[SCHEMA] Conform the schema/rules files consistently [#1078](https://github.com/bids-standard/bids-specification/pull/1078) ([ericearl](https://github.com/ericearl))
 -   \[ENH] State of the schema sprint [#1075](https://github.com/bids-standard/bids-specification/pull/1075) ([effigies](https://github.com/effigies))
+-   SCHEMA: Convert datatype lists to objects [#1074](https://github.com/bids-standard/bids-specification/pull/1074) ([effigies](https://github.com/effigies))
+-   \[SCHEMA] Define common derivatives rules [#1072](https://github.com/bids-standard/bids-specification/pull/1072) ([rwblair](https://github.com/rwblair))
+-   \[SCHEMA] Define blood.tsv columns [#1070](https://github.com/bids-standard/bids-specification/pull/1070) ([rwblair](https://github.com/rwblair))
+-   \[SCHEMA] Create context schema in meta/ [#1069](https://github.com/bids-standard/bids-specification/pull/1069) ([effigies](https://github.com/effigies))
+-   \[SCHEMA] Replace `addendum` with `description_addendum` [#1066](https://github.com/bids-standard/bids-specification/pull/1066) ([tsalo](https://github.com/tsalo))
+-   \[SCHEMA] Encode requirement levels for dataset\_description and genetic\_info [#1064](https://github.com/bids-standard/bids-specification/pull/1064) ([effigies](https://github.com/effigies))
+-   \[SCHEMA] Correlating existing validator issues to schema entries [#1063](https://github.com/bids-standard/bids-specification/pull/1063) ([bendhouseart](https://github.com/bendhouseart))
+-   \[SCHEMA] Specify column requirement levels for several tabular files [#1061](https://github.com/bids-standard/bids-specification/pull/1061) ([effigies](https://github.com/effigies))
+-   \[SCHEMA] Start drafting validation rules for ASL data [#1060](https://github.com/bids-standard/bids-specification/pull/1060) ([tsalo](https://github.com/tsalo))
+-   \[SCHEMA] Add MEG, func, and fmap metadata tables [#1054](https://github.com/bids-standard/bids-specification/pull/1054) ([tsalo](https://github.com/tsalo))
 -   \[MISC] Preface each macro call with comment [#1052](https://github.com/bids-standard/bids-specification/pull/1052) ([Remi-Gau](https://github.com/Remi-Gau))
--   \[ENH] allow for .png and .tif in eeg/ieeg/meg as allowed for micr [#1049](https://github.com/bids-standard/bids-specification/pull/1049) ([yarikoptic](https://github.com/yarikoptic))
 -   \[FIX] typo in "rawdata" example [#1045](https://github.com/bids-standard/bids-specification/pull/1045) ([sappelhoff](https://github.com/sappelhoff))
 -   \[MISC] consistently use "directory" instead of "folder" as a term [#1044](https://github.com/bids-standard/bids-specification/pull/1044) ([sappelhoff](https://github.com/sappelhoff))
 -   \[MISC] Update CODEOWNERS [#1040](https://github.com/bids-standard/bids-specification/pull/1040) ([erdalkaraca](https://github.com/erdalkaraca))
 -   \[ENH] Allow README file extensions. [#1033](https://github.com/bids-standard/bids-specification/pull/1033) ([mateuszpawlik](https://github.com/mateuszpawlik))
 -   \[MISC] Rewrite and update html build instructions [#1032](https://github.com/bids-standard/bids-specification/pull/1032) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Clarify that BIDS standard template data is to be in scanner coordinates (MEG, iEEG, EEG) [#1031](https://github.com/bids-standard/bids-specification/pull/1031) ([alexrockhill](https://github.com/alexrockhill))
+-   \[SCHEMA] Define YAML tables for DWI/ASL/(i)EEG/micr/beh metadata [#1029](https://github.com/bids-standard/bids-specification/pull/1029) ([tsalo](https://github.com/tsalo))
 -   \[FIX] Add coordsystem-specific definition of DigitizedHeadPoints [#1023](https://github.com/bids-standard/bids-specification/pull/1023) ([tsalo](https://github.com/tsalo))
 -   \[FIX] PET Spec; added known DICOM tags, fixed tag error, updated citation, clarified scale factor. [#1021](https://github.com/bids-standard/bids-specification/pull/1021) ([bendhouseart](https://github.com/bendhouseart))
 -   \[MISC] clarify copyright for logo [#1019](https://github.com/bids-standard/bids-specification/pull/1019) ([sappelhoff](https://github.com/sappelhoff))
+-   \[SCHEMA] Define YAML tables for MRI common metadata fields and anatomy data [#1017](https://github.com/bids-standard/bids-specification/pull/1017) ([tsalo](https://github.com/tsalo))
+-   SCHEMA: Encode first two MR metadata tables as "sidecars.yml" [#1016](https://github.com/bids-standard/bids-specification/pull/1016) ([tsalo](https://github.com/tsalo))
+-   \[SCHEMA] Add datatypes field to datatype rule files [#1012](https://github.com/bids-standard/bids-specification/pull/1012) ([tsalo](https://github.com/tsalo))
 -   \[FIX] Change recording entity to REQUIRED for pet/blood modality [#1005](https://github.com/bids-standard/bids-specification/pull/1005) ([ghisvail](https://github.com/ghisvail))
 -   \[ENH] Microscopy: Add IntendedFor metadata field to photo files [#1000](https://github.com/bids-standard/bids-specification/pull/1000) ([mariehbourget](https://github.com/mariehbourget))
 -   \[ENH] Introduce the atlas entity for derivatives data [#997](https://github.com/bids-standard/bids-specification/pull/997) ([sebastientourbier](https://github.com/sebastientourbier))
 -   \[ENH] Clearly define "entity" in common principles [#947](https://github.com/bids-standard/bids-specification/pull/947) ([Lestropie](https://github.com/Lestropie))
--   \[ENH] Add BIDS URIs and deprecate relative paths, RawSources and (possibly unused) BasedOn [#918](https://github.com/bids-standard/bids-specification/pull/918) ([effigies](https://github.com/effigies))
 -   \[ENH] BEP030: Functional Near-Infrared Spectroscopy [#802](https://github.com/bids-standard/bids-specification/pull/802) ([rob-luke](https://github.com/rob-luke))
 -   \[FIX] Clarify run entity to accommodate multiple imaging modalities [#760](https://github.com/bids-standard/bids-specification/pull/760) ([yarikoptic](https://github.com/yarikoptic))
 
 ## [v1.7.0](https://github.com/bids-standard/bids-specification/tree/v1.7.0) (2022-02-15)
 
+-   \[ENH] add metadata to PET calibration factor: "DoseCalibrationFactor" [#825](https://github.com/bids-standard/bids-specification/pull/825) ([CPernet](https://github.com/CPernet))
 -   \[FIX] Use wikipedia for TIFF URL, adobe's page is 404ing now [#1007](https://github.com/bids-standard/bids-specification/pull/1007) ([yarikoptic](https://github.com/yarikoptic))
 -   \[FIX] update highlighting of examples, JSON keys and values, and TSV headers or values in the schema [#998](https://github.com/bids-standard/bids-specification/pull/998) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[MISC] minor wording and consistency improvements for channels.tsv in EEG, MEG, iEEG [#993](https://github.com/bids-standard/bids-specification/pull/993) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] typo: extra sentence in anat section [#991](https://github.com/bids-standard/bids-specification/pull/991) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[FIX] Optionally support echo entity for VFA suffix [#989](https://github.com/bids-standard/bids-specification/pull/989) ([TheChymera](https://github.com/TheChymera))
--   \[FIX] update definition acq_time for sessions.tsv [#986](https://github.com/bids-standard/bids-specification/pull/986) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[FIX] update definition acq\_time for sessions.tsv [#986](https://github.com/bids-standard/bids-specification/pull/986) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[FIX] add microscopy to modalities in schema [#984](https://github.com/bids-standard/bids-specification/pull/984) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[MISC] update steering group composition [#976](https://github.com/bids-standard/bids-specification/pull/976) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[MISC] customize footer on html spec [#975](https://github.com/bids-standard/bids-specification/pull/975) ([sappelhoff](https://github.com/sappelhoff))
@@ -134,7 +183,8 @@
 -   \[FIX] Spelling errors in appendices [#951](https://github.com/bids-standard/bids-specification/pull/951) ([Lestropie](https://github.com/Lestropie))
 -   \[FIX] Broken hyperlink in entity list file [#949](https://github.com/bids-standard/bids-specification/pull/949) ([Lestropie](https://github.com/Lestropie))
 -   \[FIX] Rewrite inheritance principle [#946](https://github.com/bids-standard/bids-specification/pull/946) ([Lestropie](https://github.com/Lestropie))
--   \[FIX] Typo: ECG_headshape [#942](https://github.com/bids-standard/bids-specification/pull/942) ([Moo-Marc](https://github.com/Moo-Marc))
+-   Address BEP031 macro requests [#945](https://github.com/bids-standard/bids-specification/pull/945) ([tsalo](https://github.com/tsalo))
+-   \[FIX] Typo: ECG\_headshape [#942](https://github.com/bids-standard/bids-specification/pull/942) ([Moo-Marc](https://github.com/Moo-Marc))
 -   \[FIX] description: dwi is specialized T2 weighting, not T2\* [#939](https://github.com/bids-standard/bids-specification/pull/939) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] relax unrealistically strict requirements with ieeg channels.tsv 'name' column [#938](https://github.com/bids-standard/bids-specification/pull/938) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Add links from derivatives section to entity list [#936](https://github.com/bids-standard/bids-specification/pull/936) ([sappelhoff](https://github.com/sappelhoff))
@@ -144,7 +194,7 @@
 -   \[ENH] Render valid value restrictions in tables based on object definitions in schema [#921](https://github.com/bids-standard/bids-specification/pull/921) ([tsalo](https://github.com/tsalo))
 -   \[ENH] add `hemi` entity to schema [#917](https://github.com/bids-standard/bids-specification/pull/917) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[ENH] update and reformat table for template in coordinate system page [#903](https://github.com/bids-standard/bids-specification/pull/903) ([Remi-Gau](https://github.com/Remi-Gau))
--   \[ENH] add details for content of `\*\_beh.json` [#902](https://github.com/bids-standard/bids-specification/pull/902) ([Remi-Gau](https://github.com/Remi-Gau))
+-   \[ENH] add details for content of `*_beh.json` [#902](https://github.com/bids-standard/bids-specification/pull/902) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[FIX] small typo in json example [#897](https://github.com/bids-standard/bids-specification/pull/897) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[INFRA] Document \*.webm video files as binary [#895](https://github.com/bids-standard/bids-specification/pull/895) ([DimitriPapadopoulos](https://github.com/DimitriPapadopoulos))
 -   \[SCHEMA] Reorganize schema code into a package [#892](https://github.com/bids-standard/bids-specification/pull/892) ([tsalo](https://github.com/tsalo))
@@ -174,7 +224,6 @@
 -   \[FIX] Remove last hardcoded suffix table [#833](https://github.com/bids-standard/bids-specification/pull/833) ([tsalo](https://github.com/tsalo))
 -   \[MISC] make explicit that EDF+ (and for EEG: BDF+) are included in iEEG / EEG format requirements [#831](https://github.com/bids-standard/bids-specification/pull/831) ([sappelhoff](https://github.com/sappelhoff))
 -   \[SCHEMA] Add TSV column files [#827](https://github.com/bids-standard/bids-specification/pull/827) ([tsalo](https://github.com/tsalo))
--   \[ENH] add metadata to PET calibration factor: "DoseCalibrationFactor" [#825](https://github.com/bids-standard/bids-specification/pull/825) ([CPernet](https://github.com/CPernet))
 -   \[FIX] correct file location of scans.tsv file in example [#824](https://github.com/bids-standard/bids-specification/pull/824) ([ghisvail](https://github.com/ghisvail))
 -   \[MISC] update available datatypes in specification [#819](https://github.com/bids-standard/bids-specification/pull/819) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] document required column order MEG, EEG, iEEG, PET, and fix typo iEEG [#818](https://github.com/bids-standard/bids-specification/pull/818) ([sappelhoff](https://github.com/sappelhoff))
@@ -208,25 +257,25 @@
 
 ## [v1.6.0](https://github.com/bids-standard/bids-specification/tree/v1.6.0) (2021-04-22)
 
+-   \[ENH] Bep 009: Positron Emission Tomography [#633](https://github.com/bids-standard/bids-specification/pull/633) ([melanieganz](https://github.com/melanieganz))
 -   \[FIX] Typos discovered by codespell [#784](https://github.com/bids-standard/bids-specification/pull/784) ([yarikoptic](https://github.com/yarikoptic))
 -   \[FIX] Rename "Unit" metadata to "Units" for consistency with existing fields [#773](https://github.com/bids-standard/bids-specification/pull/773) ([effigies](https://github.com/effigies))
 -   \[FIX] typo in pet: institution -> institutional [#771](https://github.com/bids-standard/bids-specification/pull/771) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] install git in linkchecker job [#767](https://github.com/bids-standard/bids-specification/pull/767) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] Fix CircleCI workflows [#764](https://github.com/bids-standard/bids-specification/pull/764) ([sappelhoff](https://github.com/sappelhoff))
--   \[INFRA] do not run remark on auto CHANGES [#755](https://github.com/bids-standard/bids-specification/pull/755) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Mix up (typo) between ficiduals and landmarks in EEG spec [#754](https://github.com/bids-standard/bids-specification/pull/754) ([rob-luke](https://github.com/rob-luke))
 -   \[INFRA] updating remark, CIs, contributor docs [#745](https://github.com/bids-standard/bids-specification/pull/745) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] schema for i/eeg coordsys+elecs: sub-ses-acq-space are allowed entities [#743](https://github.com/bids-standard/bids-specification/pull/743) ([sappelhoff](https://github.com/sappelhoff))
 -   \[MISC] move schema documentation into the schema directory [#740](https://github.com/bids-standard/bids-specification/pull/740) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[MISC] standardize string examples format in tables [#739](https://github.com/bids-standard/bids-specification/pull/739) ([Remi-Gau](https://github.com/Remi-Gau))
--   \[MISC] Clarify participant_id in participants.tsv file if it exists [#738](https://github.com/bids-standard/bids-specification/pull/738) ([adam2392](https://github.com/adam2392))
+-   \[MISC] Clarify participant\_id in participants.tsv file if it exists [#738](https://github.com/bids-standard/bids-specification/pull/738) ([adam2392](https://github.com/adam2392))
 -   \[FIX] split MEG files should be listed separately in scans.tsv [#735](https://github.com/bids-standard/bids-specification/pull/735) ([eort](https://github.com/eort))
 -   \[FIX] 1) Clarify appropriate labels for space entity, 2) Clarify channels+electrodes do not have to match [#734](https://github.com/bids-standard/bids-specification/pull/734) ([sappelhoff](https://github.com/sappelhoff))
 -   \[MISC] refactor stimuli mentioning sections in the events page [#697](https://github.com/bids-standard/bids-specification/pull/697) ([Remi-Gau](https://github.com/Remi-Gau))
--   \[ENH] Bep 009: Positron Emission Tomography [#633](https://github.com/bids-standard/bids-specification/pull/633) ([melanieganz](https://github.com/melanieganz))
 
 ## [v1.5.0](https://github.com/bids-standard/bids-specification/tree/v1.5.0) (2021-02-23)
 
+-   \[ENH] Add "multipart DWI" acquisitions and refactor DWI specifications [#624](https://github.com/bids-standard/bids-specification/pull/624) ([oesteban](https://github.com/oesteban))
 -   \[MISC] Updated TotalAcquiredVolumes into TotalAcquiredPairs [#742](https://github.com/bids-standard/bids-specification/pull/742) ([effigies](https://github.com/effigies))
 -   \[SCHEMA] Update qMRI fieldmap schema [#728](https://github.com/bids-standard/bids-specification/pull/728) ([effigies](https://github.com/effigies))
 -   \[FIX] Add deprecated anatomical MRI suffixes back into schema [#725](https://github.com/bids-standard/bids-specification/pull/725) ([tsalo](https://github.com/tsalo))
@@ -259,12 +308,12 @@
 -   \[ENH] Update genetics-BIDS citation [#646](https://github.com/bids-standard/bids-specification/pull/646) ([effigies](https://github.com/effigies))
 -   \[SCHEMA] Add derivatives entities to the schema [#645](https://github.com/bids-standard/bids-specification/pull/645) ([tsalo](https://github.com/tsalo))
 -   \[MISC] add brief note that TSV example in the spec may currently use either tab or space characters [#643](https://github.com/bids-standard/bids-specification/pull/643) ([yarikoptic](https://github.com/yarikoptic))
--   \[ENH] Add "multipart DWI" acquisitions and refactor DWI specifications [#624](https://github.com/bids-standard/bids-specification/pull/624) ([oesteban](https://github.com/oesteban))
 -   \[SCHEMA] Render schema elements in text [#610](https://github.com/bids-standard/bids-specification/pull/610) ([tsalo](https://github.com/tsalo))
 -   \[ENH] Add part entity for complex-valued data [#424](https://github.com/bids-standard/bids-specification/pull/424) ([tsalo](https://github.com/tsalo))
 
 ## [v1.4.1](https://github.com/bids-standard/bids-specification/tree/v1.4.1) (2020-10-13)
 
+-   \[ENH] Extend date time information to include optional UTC syntax, warn about FIF requirements [#546](https://github.com/bids-standard/bids-specification/pull/546) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] minor robustness enhancements to pdf build shell script  [#642](https://github.com/bids-standard/bids-specification/pull/642) ([yarikoptic](https://github.com/yarikoptic))
 -   \[FIX] consistent CoordinateSystem fields for ephys [#641](https://github.com/bids-standard/bids-specification/pull/641) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] set up github action to detect latin phrases [#636](https://github.com/bids-standard/bids-specification/pull/636) ([Remi-Gau](https://github.com/Remi-Gau))
@@ -292,6 +341,7 @@
 -   \[FIX] Fix link in Common principles [#583](https://github.com/bids-standard/bids-specification/pull/583) ([tsalo](https://github.com/tsalo))
 -   \[ENH] Specify how to share cross-talk and fine-calibration for Neuromag/Elekta/MEGIN data [#581](https://github.com/bids-standard/bids-specification/pull/581) ([sappelhoff](https://github.com/sappelhoff))
 -   \[ENH] Specify echo and run indices are nonnegative integers in schema [#578](https://github.com/bids-standard/bids-specification/pull/578) ([tsalo](https://github.com/tsalo))
+-   Updating the bep009 with the latest master branch updates [#576](https://github.com/bids-standard/bids-specification/pull/576) ([melanieganz](https://github.com/melanieganz))
 -   \[ENH] add optional presentation software name, version, OS, and code to events.json [#573](https://github.com/bids-standard/bids-specification/pull/573) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[ENH] added PPG as an accepted channel type for EEG, MEG and iEEG [#570](https://github.com/bids-standard/bids-specification/pull/570) ([robertoostenveld](https://github.com/robertoostenveld))
 -   \[INFRA] Move entity definitions to a separate page [#568](https://github.com/bids-standard/bids-specification/pull/568) ([tsalo](https://github.com/tsalo))
@@ -301,7 +351,6 @@
 -   \[FIX] Clarify requirement levels for TSV metadata fields [#555](https://github.com/bids-standard/bids-specification/pull/555) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Reorganize rec, ce entities, \_defacemask [#550](https://github.com/bids-standard/bids-specification/pull/550) ([emdupre](https://github.com/emdupre))
 -   \[FIX] Clarify Upper-casing of Channels.tsv Channel Type [#548](https://github.com/bids-standard/bids-specification/pull/548) ([adam2392](https://github.com/adam2392))
--   \[ENH] Extend date time information to include optional UTC syntax, warn about FIF requirements [#546](https://github.com/bids-standard/bids-specification/pull/546) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] clarify that \<physio|stim>.json is REQUIRED [#542](https://github.com/bids-standard/bids-specification/pull/542) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Replace all non-breaking spaces with vanilla spaces [#536](https://github.com/bids-standard/bids-specification/pull/536) ([nicholst](https://github.com/nicholst))
 -   \[FIX] Clarify indices are nonnegative integers. [#535](https://github.com/bids-standard/bids-specification/pull/535) ([nicholst](https://github.com/nicholst))
@@ -314,7 +363,7 @@
 -   \[FIX] restructure and clarify \*\_physio/\*\_stim section [#513](https://github.com/bids-standard/bids-specification/pull/513) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] clarify file formats in EEG, iEEG [#511](https://github.com/bids-standard/bids-specification/pull/511) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Add links and release dates to pre GH changelog, fix formatting [#509](https://github.com/bids-standard/bids-specification/pull/509) ([sappelhoff](https://github.com/sappelhoff))
--   \[FIX] Clarify that `acq\_time` in `scans.json` refers to first data point acquired [#506](https://github.com/bids-standard/bids-specification/pull/506) ([tsalo](https://github.com/tsalo))
+-   \[FIX] Clarify that `acq_time` in `scans.json` refers to first data point acquired [#506](https://github.com/bids-standard/bids-specification/pull/506) ([tsalo](https://github.com/tsalo))
 -   \[INFRA] make circle artifact link a GH action, point to pdf [#505](https://github.com/bids-standard/bids-specification/pull/505) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Typos in DECISION-MAKING file [#504](https://github.com/bids-standard/bids-specification/pull/504) ([tsalo](https://github.com/tsalo))
 -   \[ENH] Add `Commenting on a PR` to CONTRIBUTING.md [#490](https://github.com/bids-standard/bids-specification/pull/490) ([franklin-feingold](https://github.com/franklin-feingold))
@@ -324,31 +373,42 @@
 
 ## [v1.4.0](https://github.com/bids-standard/bids-specification/tree/v1.4.0) (2020-06-11)
 
+-   \[ENH] Derived (processed) MR data [#109](https://github.com/bids-standard/bids-specification/pull/109) ([chrisgorgo](https://github.com/chrisgorgo))
 -   \[FIX] Clarify language on unsetting a key/value pair [#495](https://github.com/bids-standard/bids-specification/pull/495) ([nicholst](https://github.com/nicholst))
+-   \[ENH] Add RECOMMENDED DatasetType key to dataset description [#494](https://github.com/bids-standard/bids-specification/pull/494) ([effigies](https://github.com/effigies))
+-   \[ENH] Clarify mask/dseg/probseg in common derivatives [#489](https://github.com/bids-standard/bids-specification/pull/489) ([effigies](https://github.com/effigies))
+-   \[ENH] Reorganize derivatives [#488](https://github.com/bids-standard/bids-specification/pull/488) ([effigies](https://github.com/effigies))
 -   \[ENH] optionally allow LICENSE file [#483](https://github.com/bids-standard/bids-specification/pull/483) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] linkchecker - ignore github pull and tree URLs [#477](https://github.com/bids-standard/bids-specification/pull/477) ([yarikoptic](https://github.com/yarikoptic))
 -   \[ENH] Allow fractional seconds in scans file datetimes [#470](https://github.com/bids-standard/bids-specification/pull/470) ([tsalo](https://github.com/tsalo))
 -   \[MISC] Maintainers - `Scope` responsibility [#467](https://github.com/bids-standard/bids-specification/pull/467) ([franklin-feingold](https://github.com/franklin-feingold))
 -   \[FIX] Align tables in MRI section [#465](https://github.com/bids-standard/bids-specification/pull/465) ([sappelhoff](https://github.com/sappelhoff))
--   \[FIX] Drop `\_part-` reference from example, introduce `\_split-` entity [#460](https://github.com/bids-standard/bids-specification/pull/460) ([sappelhoff](https://github.com/sappelhoff))
+-   \[FIX] Drop `_part-` reference from example, introduce `_split-` entity [#460](https://github.com/bids-standard/bids-specification/pull/460) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] clarify participants tsv+json with examples and recommendations [#459](https://github.com/bids-standard/bids-specification/pull/459) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Remove BESA from list of restricted keywords of EEG coordsystems [#457](https://github.com/bids-standard/bids-specification/pull/457) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] add steps for release protocol (PDF upload) [#455](https://github.com/bids-standard/bids-specification/pull/455) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Add reference to PDF on front page of specification [#452](https://github.com/bids-standard/bids-specification/pull/452) ([nicholst](https://github.com/nicholst))
 -   \[INFRA] Add conditional for link-checking releases [#451](https://github.com/bids-standard/bids-specification/pull/451) ([franklin-feingold](https://github.com/franklin-feingold))
 -   \[FIX] unordered list formatting in BEP018 [#449](https://github.com/bids-standard/bids-specification/pull/449) ([sappelhoff](https://github.com/sappelhoff))
+-   \[INFRA] add zenodo badge to README [#447](https://github.com/bids-standard/bids-specification/pull/447) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] fix inconsistencies for task label between sections [#446](https://github.com/bids-standard/bids-specification/pull/446) ([Remi-Gau](https://github.com/Remi-Gau))
 -   \[FIX] update DECISION-MAKING.md document with new governance [#441](https://github.com/bids-standard/bids-specification/pull/441) ([sappelhoff](https://github.com/sappelhoff))
+-   \[FIX] specify the derivatives pipeline following #345 [#358](https://github.com/bids-standard/bids-specification/pull/358) ([CPernet](https://github.com/CPernet))
+-   ENH: Clarify the position toward non-compliant derivative datasets and files [#334](https://github.com/bids-standard/bids-specification/pull/334) ([effigies](https://github.com/effigies))
+-   \[FIX] Separate out imaging-specific "common derivatives" [#310](https://github.com/bids-standard/bids-specification/pull/310) ([effigies](https://github.com/effigies))
+-   \[FIX] Revise template-generated coordinate systems [#307](https://github.com/bids-standard/bids-specification/pull/307) ([oesteban](https://github.com/oesteban))
+-   \[ENH] Add `res` and `den` keywords to indicate resolution of resampled data [#301](https://github.com/bids-standard/bids-specification/pull/301) ([oesteban](https://github.com/oesteban))
 -   \[ENH] BEP 003: Common Derivatives [#265](https://github.com/bids-standard/bids-specification/pull/265) ([effigies](https://github.com/effigies))
+-   \[FIX] use \<label> for \_desc- - not some \<value> + clarify \<value> [#224](https://github.com/bids-standard/bids-specification/pull/224) ([yarikoptic](https://github.com/yarikoptic))
+-   \[ENH] Various proposed changes to diffusion derivatives [#205](https://github.com/bids-standard/bids-specification/pull/205) ([Lestropie](https://github.com/Lestropie))
 -   \[ENH] Add Glossary of terms/abbreviations used in the specification [#152](https://github.com/bids-standard/bids-specification/pull/152) ([yarikoptic](https://github.com/yarikoptic))
 
 ## [v1.3.0](https://github.com/bids-standard/bids-specification/tree/v1.3.0) (2020-04-14)
 
--   \[INFRA] add zenodo badge to README [#447](https://github.com/bids-standard/bids-specification/pull/447) ([sappelhoff](https://github.com/sappelhoff))
 -   \[MISC] Added contributors from VisLab [#444](https://github.com/bids-standard/bids-specification/pull/444) ([VisLab](https://github.com/VisLab))
--   \[FIX] Clarify  snake_case+CamelCase in TSV+JSON [#442](https://github.com/bids-standard/bids-specification/pull/442) ([sappelhoff](https://github.com/sappelhoff))
+-   \[FIX] Clarify  snake\_case+CamelCase in TSV+JSON [#442](https://github.com/bids-standard/bids-specification/pull/442) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Eliminate web/online-specific language [#437](https://github.com/bids-standard/bids-specification/pull/437) ([nicholst](https://github.com/nicholst))
--   \[INFRA] ensure build_docs_pdf CircleCI job runs last [#436](https://github.com/bids-standard/bids-specification/pull/436) ([sappelhoff](https://github.com/sappelhoff))
+-   \[INFRA] ensure build\_docs\_pdf CircleCI job runs last [#436](https://github.com/bids-standard/bids-specification/pull/436) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] Add issue templates for GitHub [#434](https://github.com/bids-standard/bids-specification/pull/434) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] Get latest PDF build from CircleCI artifacts [#433](https://github.com/bids-standard/bids-specification/pull/433) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] Update release protocol [#432](https://github.com/bids-standard/bids-specification/pull/432) ([franklin-feingold](https://github.com/franklin-feingold))
@@ -359,19 +419,21 @@
 -   \[INFRA] add # before heading in CHANGES [#419](https://github.com/bids-standard/bids-specification/pull/419) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] fix heading of auto changelog to be a markdown header [#417](https://github.com/bids-standard/bids-specification/pull/417) ([sappelhoff](https://github.com/sappelhoff))
 -   \[ENH] Add OPTIONAL EthicsApprovals field to dataset description [#412](https://github.com/bids-standard/bids-specification/pull/412) ([effigies](https://github.com/effigies))
+-   \[FIX] improve wording on data dictionaries [#410](https://github.com/bids-standard/bids-specification/pull/410) ([sappelhoff](https://github.com/sappelhoff))
+-   BEP 18 suggestions [#398](https://github.com/bids-standard/bids-specification/pull/398) ([effigies](https://github.com/effigies))
 -   \[ENH] BEP 018 - Genetic Information [#395](https://github.com/bids-standard/bids-specification/pull/395) ([effigies](https://github.com/effigies))
+-   \[FIX] consistent units description between EEG/MEG/iEEG. Clarify (derived) SI units + prefixes [#391](https://github.com/bids-standard/bids-specification/pull/391) ([sappelhoff](https://github.com/sappelhoff))
 
 ## [v1.2.2](https://github.com/bids-standard/bids-specification/tree/v1.2.2) (2020-02-12)
 
--   \[FIX] improve wording on data dictionaries [#410](https://github.com/bids-standard/bids-specification/pull/410) ([sappelhoff](https://github.com/sappelhoff))
+-   \[FIX] Normalization of template-generated standard spaces [#306](https://github.com/bids-standard/bids-specification/pull/306) ([oesteban](https://github.com/oesteban))
 -   \[MISC] update contributions by CPernet [#409](https://github.com/bids-standard/bids-specification/pull/409) ([CPernet](https://github.com/CPernet))
 -   \[MISC] Add Sébastien Tourbier to contributors [#394](https://github.com/bids-standard/bids-specification/pull/394) ([sebastientourbier](https://github.com/sebastientourbier))
--   \[FIX] consistent units description between EEG/MEG/iEEG. Clarify (derived) SI units + prefixes [#391](https://github.com/bids-standard/bids-specification/pull/391) ([sappelhoff](https://github.com/sappelhoff))
 -   \[MISC] moved list of extension proposals to the main BIDS website [#389](https://github.com/bids-standard/bids-specification/pull/389) ([robertoostenveld](https://github.com/robertoostenveld))
 -   \[FIX] Typos and clarifications [#386](https://github.com/bids-standard/bids-specification/pull/386) ([apjanke](https://github.com/apjanke))
 -   \[INFRA] Add watermark to drafts [#383](https://github.com/bids-standard/bids-specification/pull/383) ([effigies](https://github.com/effigies))
 -   \[MISC] Teon Brooks retiring moderator duties for BEP021 [#381](https://github.com/bids-standard/bids-specification/pull/381) ([teonbrooks](https://github.com/teonbrooks))
--   \[FIX] clarify that string is expected for HowToAcknowledge field in dataset_description.json [#380](https://github.com/bids-standard/bids-specification/pull/380) ([sappelhoff](https://github.com/sappelhoff))
+-   \[FIX] clarify that string is expected for HowToAcknowledge field in dataset\_description.json [#380](https://github.com/bids-standard/bids-specification/pull/380) ([sappelhoff](https://github.com/sappelhoff))
 -   \[MISC] Typo and style [#378](https://github.com/bids-standard/bids-specification/pull/378) ([TheChymera](https://github.com/TheChymera))
 -   \[FIX] divide readme into 3 parts [#374](https://github.com/bids-standard/bids-specification/pull/374) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Refer to BIDS consistently, instead of "\<Modality>-BIDS" [#366](https://github.com/bids-standard/bids-specification/pull/366) ([sappelhoff](https://github.com/sappelhoff))
@@ -393,7 +455,6 @@
 -   \[INFRA] Link to doc builds in CI checks [#315](https://github.com/bids-standard/bids-specification/pull/315) ([jasmainak](https://github.com/jasmainak))
 -   \[MISC] Add BEP027 - BIDS Execution to BEP list [#314](https://github.com/bids-standard/bids-specification/pull/314) ([effigies](https://github.com/effigies))
 -   \[FIX] Add CBV and phase to Entity table [#312](https://github.com/bids-standard/bids-specification/pull/312) ([tsalo](https://github.com/tsalo))
--   \[FIX] Normalization of template-generated standard spaces [#306](https://github.com/bids-standard/bids-specification/pull/306) ([oesteban](https://github.com/oesteban))
 -   \[ENH] Release protocol notes [#304](https://github.com/bids-standard/bids-specification/pull/304) ([franklin-feingold](https://github.com/franklin-feingold))
 -   \[INFRA] Adding contributor appendix sentence to PR template  [#299](https://github.com/bids-standard/bids-specification/pull/299) ([franklin-feingold](https://github.com/franklin-feingold))
 -   \[ENH] Added discontinuous datatype for EEG and iEEG [#286](https://github.com/bids-standard/bids-specification/pull/286) ([wouterpotters](https://github.com/wouterpotters))
@@ -401,6 +462,7 @@
 
 ## [v1.2.1](https://github.com/bids-standard/bids-specification/tree/v1.2.1) (2019-08-14)
 
+-   \[INFRA] Add clarification on merge methods to DECISION\_MAKING [#217](https://github.com/bids-standard/bids-specification/pull/217) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] repair link in anatomical MRI table [#297](https://github.com/bids-standard/bids-specification/pull/297) ([sappelhoff](https://github.com/sappelhoff))
 -   \[ENH] Clarify requirements in Release Protocol [#294](https://github.com/bids-standard/bids-specification/pull/294) ([franklin-feingold](https://github.com/franklin-feingold))
 -   \[INFRA] Use linkchecker (from a dedicated docker image) to check all URLs [#293](https://github.com/bids-standard/bids-specification/pull/293) ([yarikoptic](https://github.com/yarikoptic))
@@ -427,7 +489,6 @@
 -   \[INFRA] Enable version panel for quickly finding previous versions [#232](https://github.com/bids-standard/bids-specification/pull/232) ([effigies](https://github.com/effigies))
 -   \[FIX] Clarify Appendix II: The list of licenses only lists examples [#222](https://github.com/bids-standard/bids-specification/pull/222) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Trivial column header fix  [#220](https://github.com/bids-standard/bids-specification/pull/220) ([nicholst](https://github.com/nicholst))
--   \[INFRA] Add clarification on merge methods to DECISION_MAKING [#217](https://github.com/bids-standard/bids-specification/pull/217) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] Enable permalink urls to appear at (sub)section headings [#214](https://github.com/bids-standard/bids-specification/pull/214) ([yarikoptic](https://github.com/yarikoptic))
 -   \[INFRA] bump up mkdocs-materials version [#211](https://github.com/bids-standard/bids-specification/pull/211) ([sappelhoff](https://github.com/sappelhoff))
 -   \[MISC] Fix github username for @chrisgorgo [#204](https://github.com/bids-standard/bids-specification/pull/204) ([chrisgorgo](https://github.com/chrisgorgo))
@@ -450,36 +511,36 @@
 -   \[FIX] Clarify continuous recording metadata fields [#167](https://github.com/bids-standard/bids-specification/pull/167) ([effigies](https://github.com/effigies))
 -   \[FIX] changed reference of `dcm2nii` to `dcm2niix` [#166](https://github.com/bids-standard/bids-specification/pull/166) ([DimitriPapadopoulos](https://github.com/DimitriPapadopoulos))
 -   \[FIX] Removing a leftover file [#162](https://github.com/bids-standard/bids-specification/pull/162) ([chrisgorgo](https://github.com/chrisgorgo))
+-   \[MISC] Adding Dimitri Papadopoulos Orfanos to the list of contributors [#157](https://github.com/bids-standard/bids-specification/pull/157) ([DimitriPapadopoulos](https://github.com/DimitriPapadopoulos))
+-   \[FIX] use "specification" not "protocol" to refer to BIDS [#156](https://github.com/bids-standard/bids-specification/pull/156) ([yarikoptic](https://github.com/yarikoptic))
+-   \[FIX] Fix example misalignment [#155](https://github.com/bids-standard/bids-specification/pull/155) ([DimitriPapadopoulos](https://github.com/DimitriPapadopoulos))
+-   \[ENH] clarify decimal sep and numerical notation convention [#143](https://github.com/bids-standard/bids-specification/pull/143) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] Specify marker filenames for KIT data (MEG) [#62](https://github.com/bids-standard/bids-specification/pull/62) ([monkeyman192](https://github.com/monkeyman192))
 -   \[FIX] Remove father-level for meg filetypes other than BTi/4D data [#19](https://github.com/bids-standard/bids-specification/pull/19) ([teonbrooks](https://github.com/teonbrooks))
 
 ## [v1.2.0](https://github.com/bids-standard/bids-specification/tree/v1.2.0) (2019-03-04)
 
--   \[MISC] Adding Dimitri Papadopoulos Orfanos to the list of contributors [#157](https://github.com/bids-standard/bids-specification/pull/157) ([DimitriPapadopoulos](https://github.com/DimitriPapadopoulos))
--   \[FIX] use "specification" not "protocol" to refer to BIDS [#156](https://github.com/bids-standard/bids-specification/pull/156) ([yarikoptic](https://github.com/yarikoptic))
--   \[FIX] Fix example misalignment [#155](https://github.com/bids-standard/bids-specification/pull/155) ([DimitriPapadopoulos](https://github.com/DimitriPapadopoulos))
+-   \[ENH] Merge bep006 and bep010 [#108](https://github.com/bids-standard/bids-specification/pull/108) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] Update Pipfile.lock [#144](https://github.com/bids-standard/bids-specification/pull/144) ([franklin-feingold](https://github.com/franklin-feingold))
--   \[ENH] clarify decimal sep and numerical notation convention [#143](https://github.com/bids-standard/bids-specification/pull/143) ([sappelhoff](https://github.com/sappelhoff))
 -   \[ENH] clarify encoding of README, CHANGES, TSV, and JSON files [#140](https://github.com/bids-standard/bids-specification/pull/140) ([sappelhoff](https://github.com/sappelhoff))
--   \[MISC] Update site_name and release protocol [#137](https://github.com/bids-standard/bids-specification/pull/137) ([franklin-feingold](https://github.com/franklin-feingold))
+-   \[MISC] Update site\_name and release protocol [#137](https://github.com/bids-standard/bids-specification/pull/137) ([franklin-feingold](https://github.com/franklin-feingold))
 -   \[FIX] Example for IntendedFor was missing session indicator in the filename [#129](https://github.com/bids-standard/bids-specification/pull/129) ([yarikoptic](https://github.com/yarikoptic))
 -   \[ENH] Add "\_phase" suffix to func datatype for functional phase data [#128](https://github.com/bids-standard/bids-specification/pull/128) ([tsalo](https://github.com/tsalo))
--   \[MISC] Update to Release_Protocol.md [#126](https://github.com/bids-standard/bids-specification/pull/126) ([franklin-feingold](https://github.com/franklin-feingold))
+-   \[MISC] Update to Release\_Protocol.md [#126](https://github.com/bids-standard/bids-specification/pull/126) ([franklin-feingold](https://github.com/franklin-feingold))
 -   \[MISC] Update tag naming convention [#123](https://github.com/bids-standard/bids-specification/pull/123) ([chrisgorgo](https://github.com/chrisgorgo))
--   \[ENH] Merge bep006 and bep010 [#108](https://github.com/bids-standard/bids-specification/pull/108) ([sappelhoff](https://github.com/sappelhoff))
 -   \[MISC] Adding formal decision-making rules [#104](https://github.com/bids-standard/bids-specification/pull/104) ([chrisgorgo](https://github.com/chrisgorgo))
 -   \[FIX] number of small corrections to the specification [#98](https://github.com/bids-standard/bids-specification/pull/98) ([robertoostenveld](https://github.com/robertoostenveld))
 
 ## [v1.1.2](https://github.com/bids-standard/bids-specification/tree/v1.1.2) (2019-01-10)
 
 -   \[ENH] Global fields in data dictionaries [#117](https://github.com/bids-standard/bids-specification/pull/117) ([chrisgorgo](https://github.com/chrisgorgo))
+-   \[ENH] First(?) good practice recommendation. No excessive overrides in Inheritance principle [#99](https://github.com/bids-standard/bids-specification/pull/99) ([yarikoptic](https://github.com/yarikoptic))
 -   \[MISC] Propose BEP026 MER [#116](https://github.com/bids-standard/bids-specification/pull/116) ([greydongilmore](https://github.com/greydongilmore))
 -   \[FIX] Remove duplicate entries in MEG table [#113](https://github.com/bids-standard/bids-specification/pull/113) ([franklin-feingold](https://github.com/franklin-feingold))
 -   \[MISC] Propose BEP025 MIDS [#110](https://github.com/bids-standard/bids-specification/pull/110) ([josator2](https://github.com/josator2))
 -   \[FIX] repair links [#106](https://github.com/bids-standard/bids-specification/pull/106) ([sappelhoff](https://github.com/sappelhoff))
 -   \[INFRA] Autogenerate CHANGES.md [#103](https://github.com/bids-standard/bids-specification/pull/103) ([franklin-feingold](https://github.com/franklin-feingold))
 -   \[MISC] Added contributor information [#100](https://github.com/bids-standard/bids-specification/pull/100) ([jgrethe](https://github.com/jgrethe))
--   \[ENH] First(?) good practice recommendation. No excessive overrides in Inheritance principle [#99](https://github.com/bids-standard/bids-specification/pull/99) ([yarikoptic](https://github.com/yarikoptic))
 -   \[MISC] adding extensions page [#97](https://github.com/bids-standard/bids-specification/pull/97) ([choldgraf](https://github.com/choldgraf))
 -   \[FIX] fix some urls (as detected to be broken/inconsistent) [#95](https://github.com/bids-standard/bids-specification/pull/95) ([yarikoptic](https://github.com/yarikoptic))
 -   \[MISC] Change BEP numbers to include MRS [#94](https://github.com/bids-standard/bids-specification/pull/94) ([Hboni](https://github.com/Hboni))
@@ -496,7 +557,7 @@
 -   \[MISC] Updated my contributions [#75](https://github.com/bids-standard/bids-specification/pull/75) ([nicholst](https://github.com/nicholst))
 -   \[FIX] update HED appendix [#74](https://github.com/bids-standard/bids-specification/pull/74) ([sappelhoff](https://github.com/sappelhoff))
 -   \[FIX] unicode: replace greek mu and omega by micro and ohm signs [#73](https://github.com/bids-standard/bids-specification/pull/73) ([sappelhoff](https://github.com/sappelhoff))
--   \[ENH] add `ce-\<label\>` for fmri data [#70](https://github.com/bids-standard/bids-specification/pull/70) ([dasturge](https://github.com/dasturge))
+-   \[ENH] add `ce-<label>` for fmri data [#70](https://github.com/bids-standard/bids-specification/pull/70) ([dasturge](https://github.com/dasturge))
 -   \[INFRA] pin pip version [#68](https://github.com/bids-standard/bids-specification/pull/68) ([chrisgorgo](https://github.com/chrisgorgo))
 -   \[MISC] Fix link in index [#46](https://github.com/bids-standard/bids-specification/pull/46) ([chrisgorgo](https://github.com/chrisgorgo))
 -   \[MISC] edit contributing guide [#44](https://github.com/bids-standard/bids-specification/pull/44) ([patrick-g-h](https://github.com/patrick-g-h))
@@ -607,5 +668,3 @@
 ## 1.0.0-rc1
 
 -   Initial release
-
-\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

From da7ee9e11433e0ad427b228f0cb1fbe2025b93e2 Mon Sep 17 00:00:00 2001
From: Stefan Appelhoff <stefan.appelhoff@mailbox.org>
Date: Thu, 13 Jun 2024 19:28:54 +0200
Subject: [PATCH 07/18] DOC: Updates to how changelog generator is working
 (#1851)

---
 CONTRIBUTING.md     | 15 +++++----------
 Release_Protocol.md |  4 ----
 2 files changed, 5 insertions(+), 14 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 208d0bd43b..d16d54cdc5 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -721,17 +721,12 @@ The decision-making rules are outlined in
 
 The changelog (see `src/CHANGES.md`) is generated automatically using
 [github-changelog-generator](https://github.com/github-changelog-generator/github-changelog-generator).
-You can see the workflow in the CircleCI configuration file (`.circleci/config.yml`).
+You can see the workflow in the following GitHub Actions configuration file: `.github/workflows/changelog_generator.yml`.
 
-As it stands, the changelog is generated whenever a pull request is integrated into
-the `master` branch of the specification via a "Merge commit"
-(as opposed to "Squash and merge" or "Rebase and merge";
-see the [GitHub help page](https://help.github.com/en/articles/about-merge-methods-on-github)
-for more information on merge methods).
-
-![merge-commit](release_images/merge_commit.png "merge-commit")
-
-Note that for pull requests starting with `REL:`, no changelog is generated.
+This workflow is triggered for every commit to `master` that contains string `[build changelog]` in its commit message.
+If you push several commits at once, you need to make sure that the "youngest commit" (the HEAD commit) contains that string.
+The workflow will then open a Pull Request to incorporate the updated changelog.
+Check the proposed changes and merge the Pull Request at will.
 
 To exclude pull requests from showing up in the changelog, they have to be labeled with
 the "exclude-from-changelog" label.
diff --git a/Release_Protocol.md b/Release_Protocol.md
index c93c039a48..9e2f6292c6 100644
--- a/Release_Protocol.md
+++ b/Release_Protocol.md
@@ -12,10 +12,6 @@ your fork locally to a directory called `bids-specification`.
 
 Before you start a release, you have to ensure that the automatically generated changelog is **up to date**.
 See the relevant [section in CONTRIBUTING.md](CONTRIBUTING.md#how-is-the-changelog-generated) for further information.
-In practice this means ensuring that the most recently merged pull request
-was merged into the `master` branch using the "Merge commit" option.
-
-![merge-commit](release_images/merge_commit.png.png "merge-commit")
 
 ### 1. Fetch the latest version of the [master branch of the BIDS-specification](https://github.com/bids-standard/bids-specification/tree/master)
 

From 55e286981992021dcabb073af3a87a8336e489c5 Mon Sep 17 00:00:00 2001
From: Remi Gau <remi_gau@hotmail.com>
Date: Thu, 13 Jun 2024 19:32:57 +0200
Subject: [PATCH 08/18] [DOC] add maintainers guide (#1770)

* add maintainers guide

* move file

* Apply suggestions from code review

Co-authored-by: Ariel Rokem <arokem@gmail.com>

* migrate info from DECISION_MAKING.md to maintainers guide

* streamlining and additions

* fix typo

---------

Co-authored-by: Ariel Rokem <arokem@gmail.com>
Co-authored-by: Stefan Appelhoff <stefan.appelhoff@mailbox.org>
---
 DECISION-MAKING.md   |  45 ++++-----------
 Maintainers_Guide.md | 135 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 145 insertions(+), 35 deletions(-)
 create mode 100644 Maintainers_Guide.md

diff --git a/DECISION-MAKING.md b/DECISION-MAKING.md
index f31b2eacbf..cbf7946af4 100644
--- a/DECISION-MAKING.md
+++ b/DECISION-MAKING.md
@@ -14,40 +14,15 @@ BIDS governance.
 
 ### Steering Group
 
-Current and past members of the steering group can be found
-[here](https://bids.neuroimaging.io/governance.html#bids-steering-group).
+Current and past members of the steering group can be found in the
+[BIDS governance](https://bids.neuroimaging.io/governance.html#bids-steering-group).
 
 ### Maintainers Group
 
-| Name                                                                      | Time commitment | Scope                                 | Joined   |
-| ------------------------------------------------------------------------- | --------------- | ------------------------------------- | -------- |
-| Stefan Appelhoff ([@sappelhoff](https://github.com/sappelhoff))           | 1h/week         |                                       | Mar 2020 |
-| Chris Markiewicz ([@effigies](https://github.com/effigies))               | 5h/week         |                                       | Mar 2020 |
-| Ross Blair ([@rwblair](https://github.com/rwblair))                       |                 | Maintainer of the bids-validator      | Mar 2020 |
-| Taylor Salo ([@tsalo](https://github.com/tsalo))                          | 3h/week         | MRI                                   | Sep 2020 |
-| Remi Gau ([@Remi-Gau](https://github.com/Remi-Gau))                       | 3h/week         | Community development, MRI            | Oct 2020 |
-| Anthony Galassi  ([@bendhouseart](https://github.com/bendhouseart))       | 3h/week         | PET, Community development            | Sep 2021 |
-| Eric Earl ([@ericearl](https://github.com/ericearl))                      | 2h/week         |                                       | Dec 2021 |
-| Christine Rogers ([@christinerogers](https://github.com/christinerogers)) | 2h/month        | Interoperability, EEG and multi-modal | Apr 2023 |
-| Nell Hardcastle ([@nellh](https://github.com/nellh))                      | 2h/week         |                                       | Jul 2023 |
-| Kimberly Ray ([@KimberlyLRay](https://github.com/KimberlyLRay))           | 1h/week         |                                       | Nov 2022 |
-
-In addition to the [BIDS Governance](https://bids.neuroimaging.io/governance.html#bids-maintainers-group)
-classification of a maintainer, maintainers may declare a limited scope of responsibility.
-Such a scope can range from maintaining a modality supported in the specification to nurturing a
-welcoming BIDS community.
-Any number of scopes can be chosen by the maintainer and agreed upon by the Maintainers Group.
-A maintainer is primarily responsible for issues within their chosen scope(s), although
-contributions elsewhere are welcome, as well.
-
-The role of the "lead maintainer", that is, the BIDS maintainer currently representing the maintainers group,
-is rotating among current maintainers.
-
-#### Past maintainers group members
-
-| Name                                                                           | Duration            |
-| ------------------------------------------------------------------------------ | ------------------- |
-| Franklin Feingold ([@franklin-feingold](https://github.com/franklin-feingold)) | Mar 2020 - Jul 2022 |
+Current and past members of the maintainers group can be found in the
+[BIDS governance](https://bids.neuroimaging.io/governance.html#bids-maintainers-group),
+and in the
+[Maintainers Guide](Maintainers_Guide.md).
 
 ### BEP Leads Group
 
@@ -65,8 +40,9 @@ according to the instructions listed there.
 
 ### Other groups
 
-The following groups not listed in detail. Please learn more about these groups
-from the [governance document](https://bids.neuroimaging.io/governance.html).
+The following groups are not described in detail.
+Please learn more about these groups from the
+[BIDS governance](https://bids.neuroimaging.io/governance.html).
 
 - BEP working groups
 - Advisory Group
@@ -82,8 +58,7 @@ following rules with the intention to:
 - Minimize the administrative burden.
 - Provide a path for when consensus cannot be made.
 - Grow the community.
-- Maximize the [bus factor](https://en.wikipedia.org/wiki/Bus_factor) of the
-  project.
+- Maximize the [bus factor](https://en.wikipedia.org/wiki/Bus_factor) of the project.
 
 The rules outlined below are inspired by the [lazy consensus system used in the Apache Foundation](https://www.apache.org/foundation/voting.html)
 and heavily depends on [GitHub Pull Request Review system](https://help.github.com/articles/about-pull-requests/).
diff --git a/Maintainers_Guide.md b/Maintainers_Guide.md
new file mode 100644
index 0000000000..1c668ec382
--- /dev/null
+++ b/Maintainers_Guide.md
@@ -0,0 +1,135 @@
+# BIDS Maintainers Group Guide
+
+The BIDS Maintainers are a key group of members that ensure that the BIDS infrastructure is kept up.
+The maintainers have wide-ranging responsibilities that enable BIDS to continue to grow and succeed.
+As furthermore detailed in the [DECISION-MAKING document](DECISION-MAKING.md),
+maintainers have a set of rights that go beyond those of a contributor.
+
+The following guide draws heavily on a related [blog post](https://matthewrocklin.com/blog/2019/05/18/maintainer)
+on "The Role of a Maintainer" by Matthew Rocklin,
+which is a recommended reading in conjunction with this guide.
+
+## Current BIDS Maintainers
+
+See also: [BIDS governance](https://bids.neuroimaging.io/governance.html#bids-maintainers-group)
+
+| Name                                                                      | Time commitment | Scope                                 | Joined   |
+| ------------------------------------------------------------------------- | --------------- | ------------------------------------- | -------- |
+| Stefan Appelhoff ([@sappelhoff](https://github.com/sappelhoff))           | 1h/week         |                                       | Mar 2020 |
+| Chris Markiewicz ([@effigies](https://github.com/effigies))               | 5h/week         |                                       | Mar 2020 |
+| Ross Blair ([@rwblair](https://github.com/rwblair))                       |                 | Maintainer of the bids-validator      | Mar 2020 |
+| Taylor Salo ([@tsalo](https://github.com/tsalo))                          | 3h/week         | MRI                                   | Sep 2020 |
+| Remi Gau ([@Remi-Gau](https://github.com/Remi-Gau))                       | 3h/week         | Community development, MRI            | Oct 2020 |
+| Anthony Galassi  ([@bendhouseart](https://github.com/bendhouseart))       | 3h/week         | PET, Community development            | Sep 2021 |
+| Eric Earl ([@ericearl](https://github.com/ericearl))                      | 2h/week         |                                       | Dec 2021 |
+| Christine Rogers ([@christinerogers](https://github.com/christinerogers)) | 2h/month        | Interoperability, EEG and multi-modal | Apr 2023 |
+| Nell Hardcastle ([@nellh](https://github.com/nellh))                      | 2h/week         |                                       | Jul 2023 |
+| Kimberly Ray ([@KimberlyLRay](https://github.com/KimberlyLRay))           | 1h/week         |                                       | Nov 2022 |
+
+In addition to the [BIDS Governance](https://bids.neuroimaging.io/governance.html#bids-maintainers-group)
+classification of a maintainer, maintainers may declare a limited scope of responsibility.
+Such a scope can range from maintaining a modality supported in the specification to nurturing a
+welcoming BIDS community.
+Any number of scopes can be chosen by the maintainer and agreed upon by the Maintainers Group.
+A maintainer is primarily responsible for issues within their chosen scope(s), although
+contributions elsewhere are welcome, as well.
+
+### Lead Maintainer
+
+The role of the "lead maintainer", that is, the BIDS maintainer currently representing the maintainers group,
+is rotating among current maintainers.
+
+## Past BIDS Maintainers
+
+See also: [BIDS governance](https://bids.neuroimaging.io/governance.html#bids-maintainers-group)
+
+| Name                                                                           | Duration            |
+| ------------------------------------------------------------------------------ | ------------------- |
+| Franklin Feingold ([@franklin-feingold](https://github.com/franklin-feingold)) | Mar 2020 - Jul 2022 |
+
+## Why become a maintainer?
+
+As a BIDS maintainer you may get the chance to:
+
+* Learn to work as a team
+* Bring your expertise to the BIDS maintainers group and cover technical blind spots it may have
+* Improving your technical writing skills (for example documentation)
+* Learn to work with continuous integration and deployment
+* Advise and participate in the development of BIDS extensions that are most commonly associated with a publication
+
+## Responsibilities
+
+* Maintainers need to be loosely aware of the entire project
+  and use their knowledge to facilitate and initiate interactions
+  between different nodes of the project
+  and determine a reasonable and timely order for features to be added and issues to be resolved.
+* Maintainers direct other BIDS contributors in reviewing PRs,
+  writing clarifications to the specification, or other contributions.
+* Maintainers ensure that all contributors maintain a friendly and welcoming tone
+  to encourage productive conversations.
+* If no work team is suitable or available,
+  the final responsibility of getting the work done lies with the maintainers.
+* The development of each BIDS extension proposal should be "followed"
+  by at least one maintainer who acts as a preferential point of contact
+  between the BIDS maintainers and the BEP leads.
+
+Apart from these abstract and general responsibilities,
+maintainers within the BIDS community also need to ensure that the following tasks get done:
+
+* Keeping the
+  [Contributors wiki](https://github.com/bids-standard/bids-specification/wiki/Recent-Contributors)
+  up to date and assisting new contributors with adding their credits,
+  and performing community inquiries to ensure contributors are credited in the
+  [Contributors appendix](https://bids-specification.readthedocs.io/en/stable/appendices/contributors.html)
+    * Deciding what constitutes a contribution worth adding to the "Contributors list"
+* Preparing a monthly report to the BIDS Steering Group.
+  The monthly report is in the form of milestones, issues addressed,
+  and open issues raised in the past month and goals/plans for the next month.
+  The BIDS Steering Group may ask for additional information or propose a meeting to further discuss report items.
+  The report format and meetings are at the discretion of the BIDS Steering Group.
+
+Maintainers are not expected to individually be responsible for all the responsibilities listed.
+Rather, the responsibilities are distributed amongst the entire group.
+
+## Organization
+
+* The group of maintainers are a group of people with the above mentioned responsibilities,
+  who commit to convene bi-weekly meetings to discuss the project.
+* One lead maintainer represents the group to other BIDS Groups, mediates disagreement among members,
+  and casts deciding votes when needed (tie break).
+  Note that the maintainers will always strive for consensus decision making, and will try to avoid resorting to voting.
+    * The lead maintainer may delegate any of their duties to another maintainer.
+    * The lead maintainer is appointed collectively by the group of maintainers, preferably through consensus.
+    * If no one else does, the lead maintainer sets the schedule for the maintainers meeting.
+* Additions to and departures from the group are negotiated collectively between the lead maintainer
+  and the new/departing members, as they involve the redistribution of duties.
+    * If a maintainer wishes to serve for a limited term, that can be arranged at the start. Otherwise, due notice is expected.
+    * See also "How to become a maintainer?" below
+
+## How to become a maintainer?
+
+If you are interested in becoming a BIDS maintainer,
+please get in contact with an active BIDS maintainer
+(for example via opening a GitHub issue on bids-standard/bids-specification and tagging `@bids-standard/maintainers`).
+In that initial contact, it would be great if you could outline previous experience with BIDS (if any)
+and your motivation to become a maintainer, as well as particular interests for work that you would like to do.
+The BIDS maintainers will then invite you to one of the biweekly maintainers meetings (online)
+to discuss further steps and point you to the onboarding documentation (things to do).
+
+We would be happy to hear from you!
+
+## Crediting BIDS maintainers in work submissions
+
+If you prepare a submission of work related to BIDS, and would like to credit the BIDS maintainers
+in that submission, please get in touch.
+
+It is for example possible to include BIDS maintainers as a consortium author,
+through using the following OSF account: [https://osf.io/y48x9/](https://osf.io/y48x9/)
+
+We are furthermore preparing more guidelines on this topic, see this work in progress:
+https://docs.google.com/document/d/1yQdYOw7WMpkcFgT4tNalOjKuH34nhmRqg4luI4V9uhE/
+
+## Notes
+
+As detailed in the [BIDS governance](https://bids.neuroimaging.io/governance.html),
+this guide is subject to change and to amendment by the BIDS Steering Group.

From 63ef0412f237db71e5ed1be71dc01d435b3a3014 Mon Sep 17 00:00:00 2001
From: Chris Markiewicz <effigies@gmail.com>
Date: Thu, 13 Jun 2024 15:55:16 -0400
Subject: [PATCH 09/18] fix(schema): Bad README path check. Sorry.

---
 src/schema/rules/checks/hints.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/schema/rules/checks/hints.yaml b/src/schema/rules/checks/hints.yaml
index 55b63c4784..50cc0f05dc 100644
--- a/src/schema/rules/checks/hints.yaml
+++ b/src/schema/rules/checks/hints.yaml
@@ -17,7 +17,7 @@ ReadmeFileMissing:
   selectors:
     - path == '/dataset_description.json'
   checks:
-    - exists(["/README", "/README.txt", "/README.md", "/README.rst"], "dataset") > 0
+    - exists(["README", "README.txt", "README.md", "README.rst"], "dataset") > 0
 
 # 102
 TooFewAuthors:

From 9d7c1eda618bf4b7978e23a05a6a44c6e59b8e95 Mon Sep 17 00:00:00 2001
From: Chris Markiewicz <markiewicz@stanford.edu>
Date: Thu, 13 Jun 2024 18:55:22 -0400
Subject: [PATCH 10/18] [FIX] Update links to moved RRID site (#1857)

sed -i'' -e 's#https://scicrunch.org/resources#https://rrid.site#' src/**/*.{md,yaml}
---
 src/introduction.md                       |  2 +-
 src/modality-specific-files/microscopy.md |  2 +-
 src/schema/objects/columns.yaml           |  2 +-
 src/schema/objects/formats.yaml           |  2 +-
 src/schema/objects/metadata.yaml          | 10 +++++-----
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/introduction.md b/src/introduction.md
index e56f6ddef7..4315720e3a 100644
--- a/src/introduction.md
+++ b/src/introduction.md
@@ -190,4 +190,4 @@ BIDS has also a
 [Research Resource Identifier (RRID)](https://force11.org/group/resource-identification-initiative),
 which you can also include in your citations in addition to relevant publications (see above):
 
--   [`RRID:SCR_016124`](https://scicrunch.org/resources/data/record/nlx_144509-1/SCR_016124/resolver?q=SCR_016124)
+-   [`RRID:SCR_016124`](https://rrid.site/data/record/nlx_144509-1/SCR_016124/resolver?q=SCR_016124)
diff --git a/src/modality-specific-files/microscopy.md b/src/modality-specific-files/microscopy.md
index 1b813f9eb2..998e463886 100644
--- a/src/modality-specific-files/microscopy.md
+++ b/src/modality-specific-files/microscopy.md
@@ -434,7 +434,7 @@ sub-02 mus musculus C57BL/6J RRID:IMSR_JAX:000664
         "Description": "name of the strain of the species"
     },
     "strain_rrid": {
-        "Description": "research resource identifier (RRID) of the strain (https://scicrunch.org/resources/data/source/nlx_154697-1/search)"
+        "Description": "research resource identifier (RRID) of the strain (https://rrid.site/data/source/nlx_154697-1/search)"
     }
 }
 ```
diff --git a/src/schema/objects/columns.yaml b/src/schema/objects/columns.yaml
index 5ca387a007..9128a235ba 100644
--- a/src/schema/objects/columns.yaml
+++ b/src/schema/objects/columns.yaml
@@ -615,7 +615,7 @@ strain_rrid:
   display_name: Strain RRID
   description: |
     For species different from `homo sapiens`, research resource identifier
-    ([RRID](https://scicrunch.org/resources/data/source/nlx_154697-1/search))
+    ([RRID](https://rrid.site/data/source/nlx_154697-1/search))
     of the strain of the species, for example: `RRID:IMSR_JAX:000664`.
   type: string
   format: rrid
diff --git a/src/schema/objects/formats.yaml b/src/schema/objects/formats.yaml
index 804dfda885..7de4345b2d 100644
--- a/src/schema/objects/formats.yaml
+++ b/src/schema/objects/formats.yaml
@@ -95,7 +95,7 @@ participant_relative:
 rrid:
   display_name: Research resource identifier
   description: |
-    A [research resource identifier](https://scicrunch.org/resources).
+    A [research resource identifier](https://rrid.site).
   pattern: 'RRID:.+_.+'
 stimuli_relative:
   display_name: Path relative to the stimuli directory
diff --git a/src/schema/objects/metadata.yaml b/src/schema/objects/metadata.yaml
index 1b13a6a614..051a990470 100644
--- a/src/schema/objects/metadata.yaml
+++ b/src/schema/objects/metadata.yaml
@@ -2850,9 +2850,9 @@ SamplePrimaryAntibody:
   display_name: Sample Primary Antibody
   description: |
     Description(s) of the primary antibody used for immunostaining.
-    Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalog
+    Either an [RRID](https://rrid.site) or the name, supplier and catalog
     number of a commercial antibody.
-    For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the
+    For non-commercial antibodies either an [RRID](https://rrid.site) or the
     host-animal and immunogen used (for examples: `"RRID:AB_2122563"` or
     `"Rabbit anti-Human HTR5A Polyclonal Antibody, Invitrogen, Catalog # PA1-2453"`).
     MAY be an array of strings if different antibodies are used in each channel of the file.
@@ -2866,9 +2866,9 @@ SampleSecondaryAntibody:
   display_name: Sample Secondary Antibody
   description: |
     Description(s) of the secondary antibody used for immunostaining.
-    Either an [RRID](https://scicrunch.org/resources) or the name, supplier and catalog
+    Either an [RRID](https://rrid.site) or the name, supplier and catalog
     number of a commercial antibody.
-    For non-commercial antibodies either an [RRID](https://scicrunch.org/resources) or the
+    For non-commercial antibodies either an [RRID](https://rrid.site) or the
     host-animal and immunogen used (for examples: `"RRID:AB_228322"` or
     `"Goat anti-Mouse IgM Secondary Antibody, Invitrogen, Catalog # 31172"`).
     MAY be an array of strings if different antibodies are used in each channel of the file.
@@ -3148,7 +3148,7 @@ SoftwareRRID:
   name: SoftwareRRID
   display_name: SoftwareRRID
   description: |
-    [Research Resource Identifier](https://scicrunch.org/resources) of the
+    [Research Resource Identifier](https://rrid.site) of the
     software that was used to present the stimuli.
     Examples: The RRID for Psychtoolbox is 'SCR_002881',
     and that of PsychoPy is 'SCR_006571'.

From d8397a3b85cd568ae8e1b351fdfb4e6b41a2373b Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Mon, 17 Jun 2024 15:59:40 -0400
Subject: [PATCH 11/18] Units is not for the entire file, but rather a variable
 (column or a field in sidecar) (#1849)

---
 src/schema/objects/metadata.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/schema/objects/metadata.yaml b/src/schema/objects/metadata.yaml
index 051a990470..70926904fc 100644
--- a/src/schema/objects/metadata.yaml
+++ b/src/schema/objects/metadata.yaml
@@ -3561,7 +3561,7 @@ Units:
   name: Units
   display_name: Units
   description: |
-    Measurement units for the associated file.
+    Measurement units for the associated variable.
     SI units in CMIXF formatting are RECOMMENDED
     (see [Units](SPEC_ROOT/common-principles.md#units)).
   type: string

From d25a3fd5ad431b2fd853c300c68caa8eb539dadf Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Mon, 17 Jun 2024 16:01:16 -0400
Subject: [PATCH 12/18] [ENH] Add explicit wording on DICOM terms
 correspondence (#1450)

* Add explicit wording on DICOM terms correspondence

* Extend to Based on for DICOM

* Update src/common-principles.md

Co-authored-by: Stefan Appelhoff <stefan.appelhoff@mailbox.org>

* Update avoiding "instructions to spec authors" language

Co-authored-by: Chris Markiewicz <effigies@gmail.com>

---------

Co-authored-by: Remi Gau <remi_gau@hotmail.com>
Co-authored-by: Stefan Appelhoff <stefan.appelhoff@mailbox.org>
Co-authored-by: Chris Markiewicz <effigies@gmail.com>
---
 src/common-principles.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/common-principles.md b/src/common-principles.md
index 08ef8e6a4f..da87a35e06 100644
--- a/src/common-principles.md
+++ b/src/common-principles.md
@@ -449,6 +449,11 @@ possible. Since the NIfTI standard offers limited support for the various image
 acquisition parameters available in DICOM files, we RECOMMEND that users provide
 additional meta information extracted from DICOM files in a sidecar JSON file
 (with the same filename as the `.nii[.gz]` file, but with a `.json` extension).
+Currently defined metadata fields are listed in the [Glossary](./glossary.md).
+Where possible, DICOM Tags are adopted directly as BIDS metadata terms and
+indicated with "**Corresponds to** DICOM Tag ID1, ID2 `DICOM Tag Name`.".
+When harmonization has been deemed necessary, this is indicated in the
+BIDS term description with "**Based on** DICOM Tag ID1, ID2 `DICOM Tag Name`.".
 Extraction of BIDS compatible metadata can be performed using [dcm2niix](https://github.com/rordenlab/dcm2niix)
 and [dicm2nii](https://www.mathworks.com/matlabcentral/fileexchange/42997-xiangruili-dicm2nii)
 DICOM to NIfTI converters. The [BIDS-validator](https://github.com/bids-standard/bids-validator)

From 1fb7a154bba3258133e02481b4dc4cbdf94ea73f Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 17 Jun 2024 21:01:17 +0000
Subject: [PATCH 13/18] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/pyCQA/flake8: 7.0.0 → 7.1.0](https://github.com/pyCQA/flake8/compare/7.0.0...7.1.0)
---
 .pre-commit-config.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index d6b5c19929..f7bd4f01c6 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -35,7 +35,7 @@ repos:
         files: tools/schemacode
         args: ["--settings-file", "tools/schemacode/pyproject.toml"]
   - repo: https://github.com/pyCQA/flake8
-    rev: 7.0.0
+    rev: 7.1.0
     hooks:
       - id: flake8
         args: [--config=tools/schemacode/setup.cfg]

From 1a3317aa1d2d962867c1ec8d04696fb83e385ee4 Mon Sep 17 00:00:00 2001
From: Matthieu Chourrout <83714683+chourroutm@users.noreply.github.com>
Date: Thu, 20 Jun 2024 05:28:05 +0100
Subject: [PATCH 14/18] Changed hipCT microscopy suffix to XPCT (#1822)

---
 src/modality-specific-files/microscopy.md | 4 ++--
 src/schema/objects/suffixes.yaml          | 8 ++++----
 src/schema/rules/files/raw/micr.yaml      | 2 +-
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/modality-specific-files/microscopy.md b/src/modality-specific-files/microscopy.md
index 998e463886..d095a7bb4d 100644
--- a/src/modality-specific-files/microscopy.md
+++ b/src/modality-specific-files/microscopy.md
@@ -28,7 +28,7 @@ and a guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
 -->
 {{ MACROS___make_filename_template("raw", datatypes=["micr"], suffixes=["TEM", "SEM", "uCT", "BF", "DF",
-"PC", "DIC", "FLUO", "CONF", "PLI", "CARS", "2PE", "MPE", "SR", "NLO", "OCT", "SPIM", "hipCT"], n_dupes_to_combine=4) }}
+"PC", "DIC", "FLUO", "CONF", "PLI", "CARS", "2PE", "MPE", "SR", "NLO", "OCT", "SPIM", "XPCT"], n_dupes_to_combine=4) }}
 
 Microscopy data MUST be stored in the `micr` directory.
 
@@ -88,7 +88,7 @@ and a guide for using macros can be found at
          "NLO",
          "OCT",
          "SPIM",
-         "hipCT",
+         "XPCT",
       ]
    )
 }}
diff --git a/src/schema/objects/suffixes.yaml b/src/schema/objects/suffixes.yaml
index 5f57b28ba8..b370ef646a 100644
--- a/src/schema/objects/suffixes.yaml
+++ b/src/schema/objects/suffixes.yaml
@@ -617,11 +617,11 @@ headshape:
   description: |
     The 3-D locations of points that describe the head shape and/or electrode
     locations can be digitized and stored in separate files.
-hipCT:
-  value: hipCT
-  display_name: HiP-CT
+XPCT:
+  value: XPCT
+  display_name: X-ray Phase-Contrast Tomography
   description: |
-    Hierarchical Phase-Contrast Tomography imaging data
+    X-ray phase-contrast tomography imaging data
 ieeg:
   value: ieeg
   display_name: Intracranial Electroencephalography
diff --git a/src/schema/rules/files/raw/micr.yaml b/src/schema/rules/files/raw/micr.yaml
index 52d1adb74f..b256033ce9 100644
--- a/src/schema/rules/files/raw/micr.yaml
+++ b/src/schema/rules/files/raw/micr.yaml
@@ -18,7 +18,7 @@ microscopy:
     - NLO
     - OCT
     - SPIM
-    - hipCT
+    - XPCT
   extensions:
     - .ome.tif
     - .ome.btf

From e738e35cae2c66a6acb74bc813947d1e4940b33b Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Thu, 20 Jun 2024 03:28:21 -0400
Subject: [PATCH 15/18] Correct mistyped name of "dataset_description.json"
 (#1860)

---
 src/common-principles.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/common-principles.md b/src/common-principles.md
index da87a35e06..0a42e4a885 100644
--- a/src/common-principles.md
+++ b/src/common-principles.md
@@ -351,7 +351,7 @@ Derivatives can be stored/distributed in two ways:
     it is anticipated that the same pipeline will output more than one variant
     (for example, `AFNI-blurring` and `AFNI-noblurring`).
     For the sake of consistency, the subdirectory name SHOULD be
-    the `GeneratedBy.Name` field in `data_description.json`,
+    the `GeneratedBy.Name` field in `dataset_description.json`,
     optionally followed by a hyphen and a suffix (see
     [Derived dataset and pipeline description][derived-dataset-description]).
 

From 69f37f122e642f49154079cdc8d59be340c656bc Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Mon, 24 Jun 2024 17:31:14 +0900
Subject: [PATCH 16/18] Make two Dimitis into one
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Before:

    ❯ git shortlog -sn 598a6c0749aef0180143b92937d079d9883b9c2e..
         ...
         3  Ben Dichter
         2  Dimitri Papadopoulos Orfanos
         2  Teon L Brooks
         1  Ariel Rokem
         1  Dimitri Papadopoulos

After:

    ❯ git shortlog -sn 598a6c0749aef0180143b92937d079d9883b9c2e.. | grep -v bot
         ...
         3	Ben Dichter
         3	Dimitri Papadopoulos Orfanos
         2	Teon L Brooks
---
 .mailmap | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.mailmap b/.mailmap
index 066e8097c5..087f292a4f 100644
--- a/.mailmap
+++ b/.mailmap
@@ -64,3 +64,5 @@ Patrick Park <parkpatrickj@gmail.com>
 Ezequiel Mikulan <e.mikulan@gmail.com>
 
 Guillaume Flandin <gllmflndn@users.noreply.github.com>
+
+Dimitri Papadopoulos Orfanos <3234522+DimitriPapadopoulos@users.noreply.github.com>

From 9cc8b70d8592919ccbf3e414811aeb22d3993443 Mon Sep 17 00:00:00 2001
From: Kabilar Gunalan <kabi@mit.edu>
Date: Fri, 28 Jun 2024 12:28:58 -0500
Subject: [PATCH 17/18] Remove extra bracket

---
 src/derivatives/imaging.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/derivatives/imaging.md b/src/derivatives/imaging.md
index aea21dbaad..4ba975824f 100644
--- a/src/derivatives/imaging.md
+++ b/src/derivatives/imaging.md
@@ -290,7 +290,7 @@ A guide for using macros can be found at
 A segmentation can be used to generate a binary mask that functions as a
 discrete "label" for a single structure.
 In this case, the mask suffix MUST be used,
-the [`label` entity](../appendices/entities.md#label)) SHOULD be used
+the [`label` entity](../appendices/entities.md#label) SHOULD be used
 to specify the masked structure
 (see [Common image-derived labels](#common-image-derived-labels)),
 and the [`seg` entity](../appendices/entities.md#segmentation) SHOULD be defined.

From 555f46127044b829cd26fcc65f3ee49c8a0985c2 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 1 Jul 2024 22:11:37 +0000
Subject: [PATCH 18/18] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/pre-commit/mirrors-mypy: v1.10.0 → v1.10.1](https://github.com/pre-commit/mirrors-mypy/compare/v1.10.0...v1.10.1)
---
 .pre-commit-config.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index f7bd4f01c6..5e1ed3b234 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -57,7 +57,7 @@ repos:
       - id: codespell
         args: ["--config=.codespellrc", "--dictionary=-", "--dictionary=.codespell_dict"]
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.10.0
+    rev: v1.10.1
     hooks:
       - id: mypy
         # Sync with project.optional-dependencies.typing