<commit_before>20.2.0 (TBD)
============
With this third minor release series of 2020,
the first *fMRIPrep LTS* (*long-term support*) is finally here!

This release contains a number of bug-fixes and enhancements mostly
related to easing the maintenance, anticipating patch-release breaking
changes to ensure a longstanding LTS, and addressing some run-to-run
repeatability problems of the CompCor implementation.

.. admonition:: Long-Term Support (LTS)

    *fMRIPrep* 20.2 LTS introduces the `long-term support program
    <https://www.nipreps.org/devs/releases/#long-term-support-series>`__.
    This LTS version will be kindly steered and maintained by
    the group of Dr. <NAME> and Prof. <NAME> at
    `CRIUGM <http://www.criugm.qc.ca/>`__, (Université de Montréal).
    The LTS is planned for a window of 4 years of support (i.e., until
    September 2024).

.. caution::

    As with all minor version increments, working directories
    from previous versions **should not be reused**.

Thank you for using *fMRIPrep*!
If you encounter any issues with this release, please let us know
by posting an issue on our GitHub page!

A full list of changes can be found below.

* FIX: Revise the reproducibility of CompCor masks (#2130)
* FIX: Simplify transform aggregation in resampling, pass identity transforms for multi-echo cases (#2239)
* FIX: Skip the T1w check if ``--anat-derivatives`` is provided. (#2201)
* FIX: Storing ``--bids-filters`` within config file (#2177)
* FIX: Revise multi-echo reference generation, permitting using SBRefs too (#1803)
* FIX: FreeSurfer license manipulation & canary
* ENH: Output CompCor masks if ``--debug compcor`` is passed (#2248)
* ENH: Conform to BIDS Derivatives as of BIDS 1.4.0 (#2223)
* ENH: Reuse config (#2240)
* ENH: Save BOLD-anatomical transforms to derivatives folder (#2233)
* ENH: Leverage BIDSLayout's ``database_path`` (#2203)
* ENH: Add ``--no-tty`` option to ``fmriprep-docker.py`` (#2204)
* ENH: Report number of echoes in BOLD summary. (#2184)
* ENH: Ensure NiPype telemetry is just pinged once (#2168)
* DOC: Update reference in "Refinement of Brain Mask" description (#2215)
* DOC: List *TemplateFlow* templates that need to be prefetched (#2196)
* DOC: Update references to https://github.com/nipreps (#2191)
* DOC: Pin NiPype with new Sphinx extension syntax (#2092)
* MAINT: Track #2252 from 20.1.x series (#2253)
* MAINT: Silence PyBIDS warning by setting extension mode (#2250)
* MAINT: Drop CircleCI docs build (#2247)
* MAINT: Pin latest *NiPreps* (#2244)
* MAINT: Update ``setup.cfg`` (flake8 and pytest) (#2183)
* MAINT: Delete release-drafter (#2169)
* MAINT: Track bug-fix release on the 20.1.x series (#2165)
* MAINT: Remove auto-comment bot (#2166)
* MAINT: Improve the questions on the bug-report template (#2158)

.. admonition:: Author list for papers based on *fMRIPrep* 20.2 LTS series

    As described in the `Contributor Guidelines
    <https://www.nipreps.org/community/CONTRIBUTING/#recognizing-contributions>`__,
    anyone listed as developer or contributor may write and submit manuscripts<commit_msg>rel(20.2.0rc1): Update CHANGES [skip ci]<commit_after>20.2.0 (TBD)
============
With this third minor release series of 2020,
the first *fMRIPrep LTS* (*long-term support*) is finally here!

This release contains a number of bug-fixes and enhancements mostly
related to easing the maintenance, anticipating patch-release breaking
changes to ensure a longstanding LTS, and addressing some run-to-run
repeatability problems of the CompCor implementation.

.. admonition:: Long-Term Support (LTS)

    *fMRIPrep* 20.2 LTS introduces the `long-term support program
    <https://www.nipreps.org/devs/releases/#long-term-support-series>`__.
    This LTS version will be kindly steered and maintained by
    the group of Dr. <NAME> and Prof. <NAME> at
    `CRIUGM <http://www.criugm.qc.ca/>`__, (Université de Montréal).
    The LTS is planned for a window of 4 years of support (i.e., until
    September 2024).

.. caution::

    As with all minor version increments, working directories
    from previous versions **should not be reused**.

Thank you for using *fMRIPrep*!
If you encounter any issues with this release, please let us know
by posting an issue on our GitHub page!

A full list of changes can be found below.

* FIX: Get missing ``probseg`` file from MNI152NLin2009cAsym (#2271)
* FIX: Restore ``--ignore t2w/flair`` options (#2260)
* FIX: Revise the reproducibility of *CompCor* masks (#2130)
* FIX: Simplify transform aggregation in resampling, pass identity transforms for multi-echo cases (#2239)
* FIX: Skip the T1w check if ``--anat-derivatives`` is provided. (#2201)
* FIX: Storing ``--bids-filters`` within config file (#2177)
* FIX: Revise multi-echo reference generation, permitting using SBRefs too (#1803)
* FIX: *FreeSurfer* license manipulation & canary
* ENH: Output CompCor masks if ``--debug compcor`` is passed (#2248)
* ENH: Conform to BIDS Derivatives as of BIDS 1.4.0 (#2223)
* ENH: Reuse config (#2240)
* ENH: Save BOLD-anatomical transforms to derivatives folder (#2233)
* ENH: Leverage BIDSLayout's ``database_path`` (#2203)
* ENH: Add ``--no-tty`` option to ``fmriprep-docker.py`` (#2204)
* ENH: Report number of echoes in BOLD summary. (#2184)
* ENH: Ensure *NiPype* telemetry is just pinged once (#2168)
* DOC: Add FAQ entry for using pre-indexed layouts (#2256)
* DOC: Update reference in "Refinement of Brain Mask" description (#2215)
* DOC: List *TemplateFlow* templates that need to be prefetched (#2196)
* DOC: Update references to https://github.com/nipreps (#2191)
* DOC: Pin *NiPype* with new Sphinx extension syntax (#2092)
* MAINT: Track #2269 and #2269, bug-fixes on the 20.1.x series
* MAINT: Remove derivatives from layout index ignores (#2258)
* MAINT: Track #2252 from 20.1.x series (#2253)
* MAINT: Silence *PyBIDS* warning by setting extension mode (#2250)
* MAINT: Drop CircleCI docs build (#2247)
* MAINT: Pin latest *NiPreps* (#2244)
* MAINT: Update ``setup.cfg`` (flake8 and pytest) (#2183)
* MAINT: Delete release-drafter (#2169)
* MAINT: Track bug-fix release on the 20.1.x series (#2165)
* MAINT: Remove auto-comment bot (#2166)
* MAINT: Improve the questions on the bug-report template (#2158)

.. admonition:: Author list for papers based on *fMRIPrep* 20.2 LTS series

    As described in the `Contributor Guidelines
    <https://www.nipreps.org/community/CONTRIBUTING/#recognizing-contributions>`__,
    anyone listed as developer or contributor may write and submit manuscripts
{'fraction_non_alphanumeric': 0.11112809538367471, 'fraction_numerical': 0.04830327117089575, 'mean_word_length': 4.461602671118531, 'pattern_counts': {'":': 0, '<': 13, '<?xml version=': 0, '>': 13, 'https://': 6, 'lorem ipsum': 0, 'www.': 6, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2296266', 'n_tokens_mistral': 2325, 'n_tokens_neox': 2007, 'n_words': 836}