feat: Add introduction section on reproducible research

[matthewfeickert]

• Explain what reproducibility means and what is computational reproducibility.
• Add glossary terms for 'computer platform' and 'computational reproducibility'.

[github-actions]

Thank you!

Thank you for your pull request 😃

🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

• 🎯 correct output
• 🖼️ correct figures
• ❓ new warnings
• ‼️ new errors

Rendered Changes

🔍 Inspect the changes: https://github.com/carpentries-incubator/reproducible-ml-workflows/compare/md-outputs..md-outputs-PR-11

The following changes were observed in the rendered markdown documents:

 introduction.md | 181 +++++++++++++++++++++++++++++++++++---------------------
 md5sum.txt      |   4 +-
 reference.md    |   8 +++
 3 files changed, 123 insertions(+), 70 deletions(-)

What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible.

This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

⏱️ Updated at 2025-05-26 16:14:04 +0000

[matthewfeickert]

CI is currently failing given the workflow step

reproducible-ml-workflows/.github/workflows/pr-preflight.yaml

Lines 26 to 32 in 59bd779

	- name: "Check PR"
	id: check-pr
	uses: carpentries/actions/check-valid-pr@main
	with:
	pr: ${{ github.event.number }}
	invalid: ${{ fromJSON(steps.hash.outputs.json)[github.repository] }}
	fail_on_error: true

is broken as described in carpentries/actions#111.

[matthewfeickert]

Seems to be a GitHub status issue: carpentries/actions#111 (comment)