Apply suggestions from @oesteban code review

Co-Authored-By: Oscar Esteban <[email protected]>

Author: rciric

docs/outputs.rst

@@ -276,7 +276,7 @@ frames with sudden and large motion or intensity spikes.
 - ``framewise_displacement`` - is a quantification of the estimated bulk-head motion calculated using
   formula proposed by [Power2012]_;
 - ``rmsd`` - is a quantification of the estimated relative (frame-to-frame) bulk head motion
-  calculated using the root mean square (RMS) approach of [Jenkinson2002]_;
+  calculated using the :abbr:`RMS (root mean square)` approach of [Jenkinson2002]_;
 - ``dvars`` - the derivative of RMS variance over voxels (or :abbr:`DVARS (derivative of
   RMS variance over voxels)`) [Power2012]_;
 - ``std_dvars`` - standardized :abbr:`DVARS (derivative of RMS variance over voxels)`;
@@ -533,7 +533,7 @@ See implementation on :mod:`~fmriprep.workflows.bold.confounds.init_bold_confs_w
 
   .. [Jenkinson2002] Jenkinson M, Bannister P, Brady M, Smith S. Improved optimization for the
      robust and accurate linear registration and motion correction of brain images. Neuroimage.
-     2002. doi:`10.1016/s1053-8119(02)91132-8 <https://doi.org/10.1016/s1053-8119(02)91132-8>`
+     2002. doi:`10.1016/s1053-8119(02)91132-8 <https://doi.org/10.1016/s1053-8119(02)91132-8>`__.
 
   .. [Lindquist2019] Lindquist, MA, Geuter, S, and Wager, TD, Caffo, BS,
      Modular preprocessing pipelines can reintroduce artifacts into fMRI data.

fmriprep/workflows/bold/confounds.py

@@ -99,7 +99,7 @@ def init_bold_confs_wf(
     movpar_file
         SPM-formatted motion parameters file
     rmsd_file
-        Jenkinson framewise displacement file
+        Framewise displacement as measured by ``fsl_motion_outliers``.
     skip_vols
         number of non steady state volumes
     t1w_mask