Expand ‘Reproducibility’ docs page

[khaeru]

• Merge/consolidate text formerly in doc/repro.rst in message_data.
  • Update and improve text to match current practice.
  • Organize page under the headings "Documentation", "Testing", "Versioning and naming"
• Add a list and scheme for external model names (closes Add docs page for model names #224)

How to review

• View the diff.
• Read the RTD preview of the updated page: https://iiasa-energy-program-message-ix--226.com.readthedocs.build/projects/models/en/226/repro.html and note:
  • Spelling and grammar errors.
  • Changes for clarity.
  • Is the text useful as a guide for practice in IIASA ECE?
  • Is the text useful to explain to external audiences the meaning of model names?
• Leave comments and suggestions per the above.

PR checklist

• Continuous integration checks all ✅
• Add or expand tests; coverage checks both ✅
• Add, expand, or update documentation.
• Update doc/whatsnew.

[khaeru]

@macflo8, requesting your review here as this tries to encapsulate our Slack discussion. Please let me know if there are particular points I made there that should be included here, and where.

@behnam-zakeri, you asked in today's MESSAGE meeting about a list of model names; you can see here the kernel of it, with TODOs to expand over time. Please let me know if this arrangement and the surrounding text are sufficient.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 59.5%. Comparing base (85fe745) to head (6cebe68).
Report is 5 commits behind head on main.

Additional details and impacted files

@@          Coverage Diff          @@
##            main    #226   +/-   ##
=====================================
  Coverage   59.5%   59.5%           
=====================================
  Files        195     195           
  Lines      15491   15491           
=====================================
  Hits        9225    9225           
  Misses      6266    6266           

[macflo8]

@khaeru Thanks a lot for extending the reproducibility docs. I think it offers clear instructions and explanations on how the users should work with message-ix-models to ensure reproducibility of their modelling work. The most relevant discussion points from the slack discussion are covered well here.
One point that was also discussed in the slack thread is the possible approaches to versioning/documenting of changes in sub-models (model.materials, model.transport etc.) e.g. via separate sub-model specific whatsnew pages. But this is not necessarily directly related to reproducibility, so I guess this can also be covered somewhere else.

[glatterf42]

Even though my review wasn't requested, I skimmed the page out of interested and left some notes. All in all, looks good to me, though :)