From 704844cb2ea55edb91f294cc690c2c7f061c529c Mon Sep 17 00:00:00 2001
From: Mark Mikkelsen <mark.mikkelsen@gmail.com>
Date: Mon, 8 Apr 2024 23:46:44 -0400
Subject: [PATCH] Update magnetic-resonance-spectroscopy.md

- Cosmetic edits
---
 .../magnetic-resonance-spectroscopy.md        | 36 +++++++++++++++++--
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/src/modality-specific-files/magnetic-resonance-spectroscopy.md b/src/modality-specific-files/magnetic-resonance-spectroscopy.md
index 2802834236..19e4868a48 100644
--- a/src/modality-specific-files/magnetic-resonance-spectroscopy.md
+++ b/src/modality-specific-files/magnetic-resonance-spectroscopy.md
@@ -17,11 +17,10 @@ context of the academic literature.
 <!--
 This block generates filename templates.
 The inputs for this macro can be found in the directory
-  src/schema/rules/files
+  src/schema/rules/files/raw
 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=["mrs"], suffixes=["svs", "mrsi", "unloc", "mrsref"]) }}
 
 MRS is a spectroscopic technique based on the phenomenon of nuclear magnetic resonance
@@ -152,11 +151,18 @@ The definitions of the fields specified in these tables may be found in
 A guide for using macros can be found at
  https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
 -->
-
 {{ MACROS___make_sidecar_table("mrs.MRSScannerHardware") }}
 
 #### Sequence specifics
 
+<!-- This block generates a metadata table.
+These tables are defined in
+  src/schema/rules/sidecars
+The definitions of the fields specified in these tables may be found in
+  src/schema/objects/metadata.yaml
+A guide for using macros can be found at
+ https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
+-->
 {{ MACROS___make_sidecar_table("mrs.MRSSequenceSpecifics") }}
 
 #### Tissue description
@@ -175,14 +181,38 @@ A guide for using macros can be found at
 
 Metadata fields that MUST be present:
 
+<!-- This block generates a metadata table.
+These tables are defined in
+  src/schema/rules/sidecars
+The definitions of the fields specified in these tables may be found in
+  src/schema/objects/metadata.yaml
+A guide for using macros can be found at
+ https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
+-->
 {{ MACROS___make_sidecar_table("mrs.MRSRequiredFields") }}
 
 SHOULD be present:
 
+<!-- This block generates a metadata table.
+These tables are defined in
+  src/schema/rules/sidecars
+The definitions of the fields specified in these tables may be found in
+  src/schema/objects/metadata.yaml
+A guide for using macros can be found at
+ https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
+-->
 {{ MACROS___make_sidecar_table("mrs.MRSRecommendedFields") }}
 
 MAY be present:
 
+<!-- This block generates a metadata table.
+These tables are defined in
+  src/schema/rules/sidecars
+The definitions of the fields specified in these tables may be found in
+  src/schema/objects/metadata.yaml
+A guide for using macros can be found at
+ https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
+-->
 {{ MACROS___make_sidecar_table("mrs.MRSOptionalFields") }}
 
 ### Example `*_svs.json`