trying to better match this page of the matploblib doc: https://matplotlib.org/stable/users/explain/colors/colormaps.html#overview

👋 @Remi-Gau Thanks for creating a PR!

Until this PR is ready for review, you can include the [WIP] tag in its title, or leave it as a github draft.

Please make sure it is compliant with our contributing guidelines. In particular, be sure it checks the boxes listed below.

• PR has an interpretable title.
• PR links to Github issue with mention Closes #XXXX (see our documentation on PR structure)
• Code is PEP8-compliant (see our documentation on coding style)
• Changelog or what's new entry in doc/changes/latest.rst (see our documentation on PR structure)

For new features:

• There is at least one unit test per new function / class (see our documentation on testing)
• The new feature is demoed in at least one relevant example.

For bug fixes:

• There is at least one test that would fail under the original bug conditions.

We will review it as quick as possible, feel free to ping us with questions if needed.

Codecov Report

Attention: Patch coverage is 66.66667% with 1 line in your changes missing coverage. Please review.

Project coverage is 94.32%. Comparing base (872607a) to head (371283f).
Report is 4 commits behind head on main.

@@            Coverage Diff             @@
##             main    #4851      +/-   ##
==========================================
- Coverage   94.32%   94.32%   -0.01%     
==========================================
  Files         143      143              
  Lines       18636    18630       -6     
  Branches     3105     3105              
==========================================
- Hits        17578    17572       -6     
  Misses        548      548              
  Partials      510      510              

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

HTML render of the colormap example (work in progress but feedback welcome)

https://output.circle-artifacts.com/output/job/78403e84-9b59-47bd-85e5-03990fad55cb/artifacts/0/dev/auto_examples/01_plotting/plot_colormaps.html#sphx-glr-auto-examples-01-plotting-plot-colormaps-py

I don't really like this example: it simply repeats matplotlib with little Nilearn-specificity. Its is also very technical with local functions etc, and does not comprise detailed explanations nor insights into what should be used for what purpose.

Any suggestions on how to then explain why the nilearn colormaps are better than the ones in matplotlib and how to guide user on how to choose amongst them ?
Because at the moment the colormap example is too bare bone.

Use colormaps on a simple image to give a critical view on the pros and cons of each ?

new example:
https://output.circle-artifacts.com/output/job/240e93ca-babb-49fe-8bf3-9cfa195a40c5/artifacts/0/dev/auto_examples/01_plotting/plot_colormaps.html#sphx-glr-auto-examples-01-plotting-plot-colormaps-py

compared to the old one on stable:
https://nilearn.github.io/stable/auto_examples/01_plotting/plot_colormaps.html#sphx-glr-auto-examples-01-plotting-plot-colormaps-py

Yeah I was confused by that as well.