Apply suggestions from code review (from bids-standard#622)

Co-authored-by: Chris Markiewicz <effigies@gmail.com>
oesteban · Oct 28, 2020 · 504dd30 · 504dd30
1 parent ea830e5
commit 504dd30
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 4 deletions.
diff --git a/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md b/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md
@@ -576,11 +576,11 @@ The current version of this standard considers four different scenarios:
  1. ["*PEpolar*" fieldmaps](#case-4-multiple-phase-encoded-directions-pepolar)
 
 These four different types of field mapping strategies can be encoded
-as described [below](#types-of-fieldmaps), using the following image types:
+using the following image types:
 
 | **Name**         | `suffix`         | **Description**                                                                                                                                                                                                      |
 | ---------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Magnitude        | magnitude\[1,2\] | Field-mapping MR schemes such as gradient-recalled echo (GRE) generate a Magnitude image to be used for anatomical reference. Requires the existence of Phase, Phase-difference or Fieldmap maps as described below. |
+| Magnitude        | magnitude\[1,2\] | Field-mapping MR schemes such as gradient-recalled echo (GRE) generate a Magnitude image to be used for anatomical reference. Requires the existence of Phase, Phase-difference or Fieldmap maps.                    |
 | Phase            | phase{1,2}       | Phase map generated by GRE schemes and alike, each associated with the first (`phase1`) or second (`phase2`) echoes in the sequence.                                                                                 |
 | Phase-difference | phasediff        | Some scanners subtract the `phase1` from the `phase2` map and generate a unique `phasediff` file. For instance, this is a common output for the built-in fieldmap sequence of Siemens scanners.                      |
 | Fieldmap         | fieldmap         | Some MR schemes such as spiral-echo (SE) sequences are able to directly provide maps of the *B<sub>0</sub>* field inhomogeneity.                                                                                     |

diff --git a/src/schema/entities.yaml b/src/schema/entities.yaml
@@ -77,8 +77,9 @@ direction:
   name: Phase-Encoding Direction
   entity: dir
   description: |
-    The `dir-<label>` key/value can be used to distinguish
-    different phase-encoding directions.
+    The `dir-<label>` key/value can be set to an arbitrary alphanumeric label
+    (for example, `dir-LR` or `dir-AP`) to distinguish different phase-encoding
+    directions.
   format: label
 run:
   name: Run