[DOC] Update contribution workflow

[sappelhoff]

based on #1561 I took a deeper dive into our new contributor acknowledgement tooling (thanks @Remi-Gau!) and made some minor doc adjustments.

Some things still need to be clarified, as also discussed in:

• Update contributors.md #1561 (comment)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (f86fa84) 87.97% compared to head (fe22532) 87.97%.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #1562   +/-   ##
=======================================
  Coverage   87.97%   87.97%           
=======================================
  Files          16       16           
  Lines        1356     1356           
=======================================
  Hits         1193     1193           
  Misses        163      163           

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

[sappelhoff]

Somewhere else in the docs it say one can run the scripts with an empty new_contributors.tsv file to update everything (I guess avatar links etc.).

It confuses me that the new_contributors.tsv file currently contains dummy data: As a maintainer executing the updating steps: can I remove the dummy data? Should I add it back later?

Shouldn't such dummy data better be located under for example tools/tests/data/dummy_new_contributors.tsv ?

(Apart from this, I am still lacking a workflow to go from the wiki format to the TSV format)

[Remi-Gau]

Shouldn't such dummy data better be located under for example tools/tests/data/dummy_new_contributors.tsv ?

yes that would be preferable indeed

[Remi-Gau]

I am still lacking a workflow to go from the wiki format to the TSV format

currently this is done "by hand" by whoever needs to update the contributors page

[sappelhoff]

@Remi-Gau should we perhaps remove our own copy of the "all contributors emoji key" from our WIKI https://github.com/bids-standard/bids-specification/wiki/Recent-Contributors#contributors

???

I think leaving the link to the source is more reasonable for two reasons:

1. we don't need to check and keep it up to date (which we haven't done, so our legend is out of date)
2. the source at allcontributors also lists emoji-to-word mappings that we don't list, but which your newly developed tools apparently support

WDYT?

[Remi-Gau]

TODO

• explain how a past contributor can add more contributions (see Note more contributions from yours truly, also reordered #1617 )

[Remi-Gau]

Note: the update_contributors.py script can add new contributions to an already existing contributor so the wiki should also be used to update the list of contributions of anyone (make sure this is clear in our internal doc)

[Remi-Gau]

Good with me.

I will address the points raised here in another PR.