Addresses review comments on Issue 105

[astroDimitrios]

Fixes #105
Fixes #104

[astroDimitrios]

[ehogan]

Thanks @astroDimitrios! 🥳

We discussed:

• moving the first paragraph to the next section (I find that opening chunk of text a little overwhelming)
• adding a "Prerequisites" heading so that it shows in the left hand panel

but that first paragraph is in a special file that doesn't recognise any headings, so we agreed to leave it as it is, but I just had a thought 🤪 Would it be possible to add an opening sentence like: "Welcome to the Introduction to Git and GitHub training! This page contains learning outcomes and setup that must be completed before participating in the training" or equiavalent? Then go into the version control summary?

Would it be possible to move the Version control link to the Version Control System text in the next sentence, please?

Should the "Your instructor and organisation" sentence in the "Passkeys" section also be removed? 🤔

We also just discussed:

• me opening a new issue at https://github.com/MetOffice/azure-spice-docs for the unticked item in the original issue Feedback from the training: Summary and Setup episode #105
• making the "Long Terminal Prompts" section an expandable section
• making the "How to get help" part a full section near the top of the page
• moving the learning outcomes into their own tab, so all the outcomes from https://github.com/MetOffice/Science-Git-Migration-Project/issues/56#issuecomment-2511167781 can be listed 😊

[ehogan]

Thanks @astroDimitrios! 🎉 I believe the outstanding issues are:

1. Is there an issue (in Software Carpentry?) somewhere to track the outcome of the discussion we had related to:

• moving the first paragraph to the next section (I find that opening chunk of text a little overwhelming)
• adding a "Prerequisites" heading so that it shows in the left hand panel

but that first paragraph is in a special file that doesn't recognise any headings, so we agreed to leave it as it is.

2. This comment wasn't addressed:

Should the "Your instructor and organisation" sentence in the "Passkeys" section also be removed? 🤔

3. I still haven done:

• me opening a new issue at https://github.com/MetOffice/azure-spice-docs for the unticked item in the original issue Feedback from the training: Summary and Setup episode #105

4. Is there an issue somewhere to track:

• moving the learning outcomes into their own tab, so all the outcomes from Create learning outcomes for introduction course Science-Git-Migration-Project#56 (comment) can be listed 😊

[ehogan]

One very minor additional suggestion 😊

[ehogan]

@astroDimitrios would prefer the comment at point 2 above remains, so the only outstanding issues are opening new issues. Approving 🥳

[astroDimitrios]

An Issue has been created on the original SWC lesson to discuss moving the Summary and Setup intro text to the first episode:
swcarpentry#1062

[ehogan]

3. I still haven done:

• me opening a new issue at https://github.com/MetOffice/azure-spice-docs for the unticked item in the original issue Feedback from the training: Summary and Setup episode #105

I added a comment to https://github.com/MetOffice/azure-spice-docs/issues/194#issuecomment-2602427619 😊