[ENH] Specify that dir-<label> should correspond to PhaseEncodingDirection

[effigies]

The BIDS convention is to use dir-{AP,PA,LR,RL} for phase-encoding directions in MRI filenames, as well as PhaseEncodingDirection in JSON sidecars. This duplication has the potential for inconsistency or multiple interpretations of the meaning of AP.

This PR aims to clarify the meaning of dir-<label> when its value matches a cardinal axis, and clearly state that this meaning SHOULD be consistent with the PhaseEncodingDirection.

[oesteban]

This is great to make the situation better without introducing backward incompatible changes. I made some suggestions to be more explicit about what the problem is and providing examples, that said, the phrasing will likely require improvements.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.71%. Comparing base (04faf74) to head (aacae58).
⚠️ Report is 77 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #2097   +/-   ##
=======================================
  Coverage   82.71%   82.71%           
=======================================
  Files          20       20           
  Lines        1608     1608           
=======================================
  Hits         1330     1330           
  Misses        278      278           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[effigies]

@oesteban Would you mind giving this another review?

[oesteban]

Looks good. A couple of suggestions to make things more explicit, but I think this is really useful.