MAINT: Update CONTRIBUTING.md inspired by dMRIPrep's

.github/config.yml

@@ -3,33 +3,26 @@
 # Comment to be posted to on PRs from first time contributors in your repository
 newPRWelcomeComment: >
   Thanks for opening this pull request!
-  We have detected this is the first time for you to contribute
-  to *fMRIPrep*.
-  Please check out our [contributing guidelines](https://github.com/poldracklab/fmriprep/blob/master/CONTRIBUTING.md).
+  It looks like this is your first time contributing to *fMRIPrep*. :smile:
 
-  We invite you to list yourself as a *fMRIPrep* contributor, so if your name
-  is not already mentioned, please modify the
-  [``.zenodo.json``](https://github.com/poldracklab/fmriprep/blob/master/.zenodo.json)
-  file with your data right above Russ' entry. Example:
-
-  ```
+  We invite you to list yourself as an *fMRIPrep* contributor.
+  To learn more about what that entails and how we credit our contributors,
+  please check out the
+  [contributing guidelines](https://github.com/poldracklab/fmriprep/blob/master/CONTRIBUTING.md#recognizing-contributions).
+  If your name is not already on the list, please insert it, in alphabetical order, into the
+  [``contributors.json`` file](https://github.com/poldracklab/fmriprep/blob/master/.maint/contributors.json).
+  Example:
 
+  ```JSON
   {
      "name": "Contributor, New FMRIPrep",
      "affiliation": "Department of fMRI prep'ing, Open Science Made-Up University",
      "orcid": "<your id>"
   },
-
-  {
-     "name": "Poldrack, Russell A.",
-     "affiliation": "Department of Psychology, Stanford University",
-     "orcid": "0000-0001-6755-0259"
-  },
-
   ```
 
 
   Of course, if you want to opt-out this time there is no
   problem at all with adding your name later.
   You will be always welcome to add it in the future whenever
-  you feel it should be listed.
+  you feel it should be listed.

.mailmap

@@ -0,0 +1,51 @@
+Adriana Rivera-Dompenciel <ariveradompenciel@uiowa.edu>
+Adriana Rivera-Dompenciel <ariveradompenciel@uiowa.edu> <34017586+ariveradompenciel@users.noreply.github.com>
+Anibal Sólon Heinsfeld <anibalsolon@gmail.com>
+Asier Erramuzpe <asier.erramuzpe@gmail.com>
+Christopher J. Markiewicz <effigies@gmail.com>
+Christopher J. Markiewicz <effigies@gmail.com> <effigies@bu.edu>
+Christopher J. Markiewicz <effigies@gmail.com> <markiewicz@stanford.edu>
+Daniel J. Lurie <danjlurie@gmail.com>
+Elizabeth DuPre <emd222@cornell.edu>
+Franklin Feingold <ffein@stanford.edu>
+Franklin Feingold <ffein@stanford.edu> <35307458+franklin-feingold@users.noreply.github.com>
+Franz Liem <franz.liem@gmail.com>
+Gabriel A. Devenyi <gdevenyi@gmail.com>
+Ilkay Isik <ilkayisik@gmail.com>
+James D. Kent <james-kent@uiowa.edu>
+James D. Kent <james-kent@uiowa.edu> <jamesdkent21@gmail.com>
+James D. Kent <james-kent@uiowa.edu> Fred Mertz <mertzf@bargle.argle>
+Jarod Roland <jarod.roland@gmail.com>
+Kevin Sitek <sitek.kevin@gmail.com>
+Kevin Sitek <sitek.kevin@gmail.com> sitek <sitek.kevin@gmail.com>
+Krzysztof J. Gorgolewski <krzysztof.gorgolewski@gmail.com>
+Krzysztof J. Gorgolewski <krzysztof.gorgolewski@gmail.com> <chris.gorgolewski@gmail.com>
+Krzysztof J. Gorgolewski <krzysztof.gorgolewski@gmail.com> <filo@filo-Precision-M6500.(none)>
+Krzysztof J. Gorgolewski <krzysztof.gorgolewski@gmail.com> <filo@filo-Precision-M6500>
+Krzysztof J. Gorgolewski <krzysztof.gorgolewski@gmail.com> <filo@filo-dtc-laptop>
+Krzysztof J. Gorgolewski <krzysztof.gorgolewski@gmail.com> <filo@filolaptop>
+Krzysztof J. Gorgolewski <krzysztof.gorgolewski@gmail.com> <krzysztof.gorgolewski+fake@gmail.com>
+Marc Bue <44844855+marcbue@users.noreply.github.com>
+Markus H. Sneve <m.h.sneve@psykologi.uio.no> <44242647+markushs@users.noreply.github.com>
+Mathias Goncalves <goncalves.mathias@gmail.com>
+Mathias Goncalves <goncalves.mathias@gmail.com> <mathiasg@mit.edu>
+Mathias Goncalves <goncalves.mathias@gmail.com> <mathiasg@stanford.edu>
+Matteo Visconti di Oleggio Castello <matteo.visconti.gr@dartmouth.edu>
+Mikael Naveau <naveau.mikael@gmail.com>
+Nir Jacoby <nj2319@columbia.edu>
+Nir Jacoby <nj2319@columbia.edu> <nirjacoby@dyn-128-59-231-222.dyn.columbia.edu>
+Oscar Esteban <code@oscaresteban.es>
+Oscar Esteban <code@oscaresteban.es> <oesteban@stanford.edu>
+Pablo Velasco <pablo.velasco@nyu.edu>
+Rastko Ciric <rc042010@mymail.pomona.edu>
+Rastko Ciric <rc042010@mymail.pomona.edu> <rastko@stanford.edu>
+Rastko Ciric <rc042010@mymail.pomona.edu> <rciric@users.noreply.github.com>
+Ross Blair <rblair2@stanford.edu>
+Ross Blair <rblair2@stanford.edu> <rosswilsonblair@gmail.com>
+Romain Valabregue <romain.valabregue@upmc.fr>
+Saren Seeley <31291534+sarenseeley@users.noreply.github.com>
+Sebastian Urchs <sebastian.urchs@gmail.com>
+Sebastien Naze <naze@us.ibm.com>
+Shoshana Berleant <berleant@stanford.edu>  <shoshber@users.noreply.github.com>
+William Hedley Thompson <william.thompson@ki.se>
+William Hedley Thompson <william.thompson@ki.se> <wiheto@users.noreply.github.com>

.maint/contributors.json

@@ -0,0 +1,160 @@
+[
+  {
+    "affiliation": "Perelman School of Medicine, University of Pennsylvania, PA, USA",
+    "name": "Adebimpe, Azeez",
+    "orcid": "0000-0001-9049-0135"
+  },
+  {
+    "affiliation": "Center for Lifespan Changes in Brain and Cognition, University of Oslo",
+    "name": "Amlien, Inge K.",
+    "orcid": "0000-0002-8508-9088"
+  },
+  {
+    "affiliation": "Perelman School of Medicine, University of Pennsylvania, PA, USA",
+    "name": "Cieslak, Matthew",
+    "orcid": "0000-0002-1931-4734"
+  },
+  {
+    "affiliation": "Department of Psychiatry, McGill University",
+    "name": "Devenyi, Grabriel A.",
+    "orcid": "0000-0002-7766-1187"
+  },
+  {
+    "affiliation": "Computational Neuroimaging Lab, BioCruces Health Research Institute",
+    "name": "Erramuzpe, Asier",
+    "orcid": "0000-0002-9402-2184"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Feingold, Franklin",
+    "orcid": "0000-0002-6533-2909"
+  },
+  {
+    "affiliation": "Centre for Modern Interdisciplinary Technologies, Nicolaus Copernicus University in Toruń",
+    "name": "Finc, Karolina",
+    "orcid": "0000-0002-0157-030X"
+  },
+  {
+    "affiliation": "Donders Institute for Brain, Cognition and Behaviour, Radboud University Nijmegen",
+    "name": "Gomez, Daniel E. P.",
+    "orcid": "0000-0001-8635-021X"
+  },
+  {
+    "affiliation": [
+      "McGovern Institute for Brain Research, MIT, MA, USA",
+      "Department of Otolaryngology, Harvard Medical School, MA, USA"
+    ],
+    "name": "Ghosh, Satrajit S.",
+    "orcid": "0000-0002-5312-6729"
+  },
+  {
+    "affiliation": "Dartmouth College: Hanover, NH, United States",
+    "name": "Halchenko, Yaroslav O.",
+    "orcid": "0000-0003-3456-2493"
+  },
+  {
+    "affiliation": "Child Mind Institute",
+    "name": "Heinsfeld, Anibal S.",
+    "orcid": "0000-0002-2050-0614"
+  },
+  {
+    "affiliation": "Max Planck Institute for Empirical Aesthetics",
+    "name": "Isik, Ayse Ilkay",
+    "orcid": "0000-0002-1652-9297"
+  },
+  {
+    "affiliation": "Department of Psychology, Columbia University",
+    "name": "Jacoby, Nir",
+    "orcid": "0000-0001-7936-9991"
+  },
+  {
+    "affiliation": "URPP Dynamics of Healthy Aging, University of Zurich",
+    "name": "Liem, Franz",
+    "orcid": "0000-0003-0646-4810"
+  },
+  {
+    "affiliation": "Department of Psychology, University of California, Berkeley",
+    "name": "Lurie, Daniel J.",
+    "orcid": "0000-0001-8012-6399"
+  },
+  {
+    "affiliation": "Dartmouth College: Hanover, NH, United States",
+    "name": "Ma, Feilong",
+    "orcid": "0000-0002-6838-3971"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Moodie, Craig A.",
+    "orcid": "0000-0003-0867-1469"
+  },
+  {
+    "affiliation": "Cyceron, UMS 3408 (CNRS - UCBN), France",
+    "name": "Naveau, Mikaël",
+    "orcid": "0000-0001-6948-9068"
+  },
+  {
+    "affiliation": "Neuroscience Program, University of Iowa",
+    "name": "Rivera-Dompenciel, Adriana",
+    "orcid": "0000-0002-3339-4857"
+  },
+  {
+    "affiliation": "Department of Psychology, Florida International University",
+    "name": "Salo, Taylor",
+    "orcid": "0000-0001-9813-3167"
+  },
+  {
+    "affiliation": "Perelman School of Medicine, University of Pennsylvania, PA, USA",
+    "name": "Satterthwaite, Theodore D.",
+    "orcid": "0000-0001-7072-9399"
+  },
+  {
+    "affiliation": "Speech & Hearing Bioscience & Technology Program, Harvard University",
+    "name": "Sitek, Kevin R.",
+    "orcid": "0000-0002-2172-5786"
+  },
+  {
+    "affiliation": "Center for Lifespan Changes in Brain and Cognition, University of Oslo",
+    "name": "Sneve, Markus H.",
+    "orcid": "0000-0001-7644-7915"
+  },
+  {
+    "affiliation": "Max Planck UCL Centre for Computational Psychiatry and Ageing Research, University College London",
+    "name": "Stojić, Hrvoje",
+    "orcid": "0000-0002-9699-9052"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Thompson, William H",
+    "orcid": "0000-0002-0533-6035"
+  },
+  {
+    "affiliation": "Department of Neuroscience, University of Pennsylvania, PA, USA",
+    "name": "Tooley, Ursula A.",
+    "orcid": "0000-0001-6377-3885"
+  },
+  {
+    "affiliation": "Montreal Neurological Institute, McGill University",
+    "name": "Urchs, Sebastian",
+    "orcid": "0000-0001-5504-8579"
+  },
+  {
+    "affiliation": "CENIR, INSERM U1127, CNRS UMR 7225, UPMC Univ Paris 06 UMR S 1127, Institut du Cerveau et de la Moelle épinière, ICM, F-75013, Paris, France",
+    "name": "Valabregue, Romain",
+    "orcid": "0000-0002-1814-9570"
+  },
+  {
+    "affiliation": "Center for Brain Imaging, New York University",
+    "name": "Velasco, Pablo",
+    "orcid": "0000-0002-5749-6049"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Wright, Jessey",
+    "orcid": "0000-0001-5504-8579"
+  },
+  {
+    "affiliation": "State Key Laboratory of Cognitive Neuroscience and Learning, Beijing Normal University",
+    "name": "Ye, Zhifang",
+    "orcid": "0000-0003-0489-2619"
+  }
+]

.maint/developers.json

@@ -0,0 +1,47 @@
+[
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Blair, Ross W.",
+    "orcid": "0000-0003-3007-1056"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Ciric, Rastko",
+    "orcid": "0000-0001-6347-7939"
+  },
+  {
+    "affiliation": "Montreal Neurological Institute, McGill University",
+    "name": "DuPre, Elizabeth",
+    "orcid": "0000-0003-1358-196X"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Esteban, Oscar",
+    "orcid": "0000-0001-8435-6191"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Goncalves, Mathias",
+    "orcid": "0000-0002-7252-7771"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Gorgolewski, Krzysztof J.",
+    "orcid": "0000-0003-3321-7583"
+  },
+  {
+    "affiliation": "Neuroscience Program, University of Iowa",
+    "name": "Kent, James D.",
+    "orcid": "0000-0002-4892-2659"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Markiewicz, Christopher J.",
+    "orcid": "0000-0002-6533-164X"
+  },
+  {
+    "affiliation": "Department of Psychology, Stanford University",
+    "name": "Poldrack, Russell A.",
+    "orcid": "0000-0001-6755-0259"
+  }
+]

.maint/former.json

@@ -0,0 +1,5 @@
+[
+  {
+    "name": "Berleant, Shoshana"
+  }
+]

.maint/paper_author_list.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""Generate an author list for a new paper or abstract."""
+import sys
+from pathlib import Path
+import json
+from update_zenodo import get_git_lines, sort_contributors
+
+
+# These authors should go last
+AUTHORS_LAST = ['Gorgolewski, Krzysztof J.', 'Poldrack, Russell A.', 'Esteban, Oscar']
+
+
+def _aslist(inlist):
+    if not isinstance(inlist, list):
+        return [inlist]
+    return inlist
+
+
+if __name__ == '__main__':
+    devs = json.loads(Path('.maint/developers.json').read_text())
+    contribs = json.loads(Path('.maint/contributors.json').read_text())
+
+    author_matches, unmatched = sort_contributors(
+        devs + contribs, get_git_lines(),
+        exclude=json.loads(Path('.maint/former.json').read_text()),
+        last=AUTHORS_LAST)
+    # Remove position
+    affiliations = []
+    for item in author_matches:
+        del item['position']
+        for a in _aslist(item.get('affiliation', 'Unaffiliated')):
+            if a not in affiliations:
+                affiliations.append(a)
+
+    aff_indexes = [', '.join(['%d' % (affiliations.index(a) + 1)
+                              for a in _aslist(author.get('affiliation', 'Unaffiliated'))])
+                   for author in author_matches]
+
+    print("Some people made commits, but are missing in .maint/ "
+          "files: %s." % ', '.join(unmatched), file=sys.stderr)
+
+    print('Authors (%d):' % len(author_matches))
+    print('; '.join([
+        '%s (%s)' % (i['name'], idx) for i, idx in zip(author_matches, aff_indexes)]))
+
+    print('\n\nAffiliations:\n%s' % '\n'.join(['{0: >2}. {1}'.format(i + 1, a)
+                                               for i, a in enumerate(affiliations)]))