carpentries · brownsarahm · Jan 14, 2025 · Feb 17, 2023 · Feb 17, 2023 · Nov 18, 2024
diff --git a/episodes/01-welcome.md b/episodes/01-welcome.md
@@ -41,15 +41,15 @@ It is, however, necessary for all participants to use pronouns and names as list
 For those unfamiliar with the practice of sharing pronouns, these resources may be helpful
 for further reading:
 
-- The proper use of pronouns in language: [https://lgbt.ucsf.edu/pronounsmatter](https://lgbt.ucsf.edu/pronounsmatter)
-- The importance of using pronouns: [https://www.pronouns.org/](https://www.pronouns.org/)
-- How to use personal pronouns: [https://www.pronouns.org/how](https://www.pronouns.org/how)
-- How to deal with situations when you use the wrong pronoun: [https://www.pronouns.org/mistakes](https://www.pronouns.org/mistakes)
+- The [proper use of pronouns in language](https://lgbt.ucsf.edu/pronounsmatter)
+- The [importance of using pronouns](https://www.pronouns.org/)
+- [How to use personal pronouns](https://www.pronouns.org/how)
+- [How to deal with situations when you use the wrong pronoun](https://www.pronouns.org/mistakes)
 
 ::::::::::::::::::::::::::::::::::::::::::::::::::
 
 ![](fig/Icebreaker_Stephan_Jantzen_in_Stadthafen_Rostock_2010-12-28_perspective_correction-GD.jpg){alt='Photo of an Icebreaker ship, named Stephan Jantzen' width="600px" }  
-A different kind of "icebreaker." Photo credit: Grand-Duc, Wikipedia, [http://en.wikipedia.org/wiki/User:Grand-Duc](https://en.wikipedia.org/wiki/User:Grand-Duc)
+A different kind of "icebreaker." Photo credit: [Grand-Duc, Wikipedia](https://en.wikipedia.org/wiki/User:Grand-Duc)
 
 ## Before The Course Begins
 

diff --git a/episodes/02-practice-learning.md b/episodes/02-practice-learning.md
@@ -194,7 +194,7 @@ perhaps illustrated as:
 
 1) On a piece of paper, draw a simplified concept map of the same concept you discussed in the last activity, but this time without the analogy.
   What are 3-4 core
-  concepts involved? How are those concepts related? (Note: if you would like to try out an online tool for this exercise, visit [https://excalidraw.com](https://excalidraw.com) .)
+  concepts involved? How are those concepts related? (Note: if you would like to try out an online tool for this exercise, visit [excalidraw](https://excalidraw.com).)
 
 2) In the Etherpad, write some notes on this process. Was it difficult? Do you think it would be a useful exercise prior to teaching about your topic?
   What challenges might a novice face in creating a concept map of this kind?  

diff --git a/episodes/05-memory.md b/episodes/05-memory.md
@@ -56,8 +56,7 @@ frequent formative assessment is important.
 
 ## Test Your Working Memory
 
-This website implements a short test of working memory:
-[https://miku.github.io/activememory/][memory-test]
+This [website implements a short test of working memory][memory-test].
 
 What was your score? If you are comfortable, share your answer
 in the Etherpad.

diff --git a/episodes/09-eia.md b/episodes/09-eia.md
@@ -55,7 +55,7 @@ things that we do, things that we are, and things that we champion. Many of thes
 
 ## Discuss The Carpentries Core Values
 
-1. Take a moment to read through the Core Values on this page: [https://carpentries.org/values/][core-values]
+1. Take a moment to read through the [Core Values][core-values]
 2. Choose one core value that resonates with you. What is a decision you might make in a workshop
   that could look different if you were actively considering the core value you chose?
 

diff --git a/episodes/11-practice-teaching.md b/episodes/11-practice-teaching.md
@@ -173,15 +173,14 @@ it is OK to remind yourself:
 
 We will start by observing some examples of teaching and providing some feedback.
 
-Watch this example teaching video as a group
+Watch [this example teaching video][bad-teaching-video] as a group
 and then give feedback on it.
-[https://www.youtube.com/watch?v=-ApVt04rB4U][bad-teaching-video]
 Put your feedback in the Etherpad.
 Organize your feedback along two axes:
 positive vs. opportunities for growth (sometimes called "negative")
 and content (what was said) vs. presentation (how it was said).
 
-Note: there is a version of this video with subtitles in both Spanish and English here: [https://www.youtube.com/watch?v=jxgMVwQamO0](https://www.youtube.com/watch?v=jxgMVwQamO0)
+Note: there is a version of [this video with subtitles in both Spanish and English](https://www.youtube.com/watch?v=jxgMVwQamO0)
 
 This exercise should take about 10 minutes.
 

diff --git a/episodes/14-checkout.md b/episodes/14-checkout.md
@@ -37,7 +37,7 @@ Extensions may be granted for any reason up to 1 year from your training date.
 
 ## Be The Expert: Checkout Q \& A
 
-In small groups, read and discuss one of the three checkout procedures described on this page: [https://carpentries.github.io/instructor-training/checkout/index.html](checkout.md)
+In small groups, read and discuss one of the three [checkout procedures described on this page](checkout.md).
 Make notes in the Etherpad:
 
 - What points do you think it is most important or helpful for people to remember?
@@ -52,12 +52,12 @@ This exercise should take about 10 minutes.
 
 ## Schedule a Discussion or Demo
 
-Visit the discussion Etherpad to sign up for a session: [https://pad.carpentries.org/community-discussions](https://pad.carpentries.org/community-discussions)
+Visit the [discussion Etherpad to sign up](https://pad.carpentries.org/community-discussions) for a session.
 If the session you would like to attend is full, contact the discussion
 host and co-host to ask if you can attend.
 
 If you would prefer to do your teaching demonstration before your discussion,
-visit the demo Etherpad and sign up there: [https://pad.carpentries.org/teaching-demos](https://pad.carpentries.org/teaching-demos)
+visit the [teaching demo Etherpad and sign up there](https://pad.carpentries.org/teaching-demos)
 This demo [rubric](demos_rubric/) is provided as a guide for Trainers evaluating potential new Instructors during the teaching demonstration.
 
 If these pages are hard to navigate or you cannot find a suitable time, save these links where

diff --git a/episodes/15-carpentries.md b/episodes/15-carpentries.md
@@ -295,8 +295,7 @@ Want to **join meetings** (to meet new people or listen in)?
 
 ## Get Connected
 
-Take a couple of minutes to sign up for The Carpentries channels you want to stay involved with on this page:
-[https://carpentries.org/connect/][connect-page]
+Take a couple of minutes to sign up for [The Carpentries channels][connect-page] you want to stay involved with.
 When you are done, share a channel you find interesting or useful on the Etherpad.
 
 This exercise should take about 5 minutes.

diff --git a/episodes/17-live.md b/episodes/17-live.md
@@ -107,8 +107,8 @@ Many error messages are obscure and not written with novices in mind. Continue t
 
 ## Compare and Contrast
 
-Watch this first participatory live coding demo video: [https://youtu.be/bXxBeNkKmJE][live-coding-bad]
-and this second demo video: [https://youtu.be/SkPmwe\_WjeY][live-coding-good]
+Watch this first [participatory live coding demo video][live-coding-bad]
+and this [second demo video][live-coding-good]
 as a group and then summarize your feedback on both in the Etherpad.
 Use the 2x2 rubric for feedback we discussed earlier.
 

diff --git a/episodes/20-performance.md b/episodes/20-performance.md
@@ -25,9 +25,9 @@ process of observing and giving feedback, and to make changes to how we teach ba
 
 ## Round Two
 
-1. Before splitting into groups, read the rubric that is given to Instructor Trainers
-  as a suggested framework for evaluating the online teaching demonstration sessions that are part of Instructor checkout.  
-  [https://carpentries.github.io/instructor-training/demos\_rubric/](demos_rubric.md). (Note: demos are not scored, so this rubric is for
+1. Before splitting into groups, read the [rubric that is given to Instructor Trainers](demos_rubric.md)
+  as a suggested framework for evaluating the online teaching demonstration sessions that are part of Instructor checkout.
+  (Note: demos are not scored, so this rubric is for
   advisory purposes only.)
   What questions do you have?
 2. Return to your groups and repeat the previous live coding exercise, re-teaching the same content as before.

diff --git a/episodes/21-management.md b/episodes/21-management.md
@@ -256,9 +256,9 @@ We encourage you to **discuss an approach to managing Code of Conduct violations
 
 ## Know Your Resources
 
-1) Take 5 minutes to read through the Code of Conduct Incident Response Guidelines: [https://docs.carpentries.org/topic\_folders/policies/incident-response.html](https://docs.carpentries.org/topic_folders/policies/incident-response.html)
-2) Discuss what you have read in small groups. As questions arise, you may wish to refer to our complete Code of Conduct section in The Carpentries Handbook:
-  [https://docs.carpentries.org/topic\_folders/policies/index\_coc.html](https://docs.carpentries.org/topic_folders/policies/index_coc.html) or to the Transparency Reports released by The Carpentries Code of Conduct Committee: [https://github.com/carpentries/executive-council-info/tree/master/code-of-conduct-transparency-reports](https://github.com/carpentries/executive-council-info/tree/master/code-of-conduct-transparency-reports)
+1) Take 5 minutes to read through the [Code of Conduct Incident Response Guidelines](https://docs.carpentries.org/topic_folders/policies/incident-response.html)
+2) Discuss what you have read in small groups. As questions arise, you may wish to refer to [our complete Code of Conduct section in The Carpentries Handbook](https://docs.carpentries.org/topic_folders/policies/index_coc.html)
+  or to the [Transparency Reports released by The Carpentries Code of Conduct Committee](https://github.com/carpentries/executive-council-info/tree/master/code-of-conduct-transparency-reports).
 
 - What kinds of things could your instructional team agree upon in advance of your workshop?
 - What questions do you have about CoC enforcement?
@@ -396,13 +396,13 @@ instructions for setting them up.
 For this activity, your Trainer will put you in groups, but you may choose whether to work together or independently.
 If you work independently, you can still use your group as a resource to ask questions as they emerge.
 
-Go to the workshop template repository: [https://github.com/carpentries/workshop-template](https://github.com/carpentries/workshop-template)
+Go to the [workshop template repository](https://github.com/carpentries/workshop-template)
 
 - If you have a GitHub account (or don't mind creating one) and are comfortable doing so,
   follow the directions to begin creating a workshop website using your local location and today's date.
 
 - Alternatively, have a look at the video tutorial linked on the instructions page. With any time
-  remaining, have a look at the websites for upcoming Carpentries workshops on our website: [https://carpentries.org/upcoming\_workshops/](https://carpentries.org/upcoming_workshops/)
+  remaining, have a look at the websites for [upcoming Carpentries workshops](https://carpentries.org/upcoming_workshops/)
 
 - Add your questions and thoughts on this process to the Etherpad. If you created a workshop website,
   add the link there as well.
@@ -413,7 +413,7 @@ Note: Sometimes web browsers will cache the workshop webpage, so when
 you make changes in GitHub, they do not show up on the workshop webpage
 immediately.  Two ways to avoid this are to use a "private" or
 "incognito" mode in your web browser or by following these
-instructions to bypass your browser cache: [https://en.wikipedia.org/wiki/Wikipedia:Bypass\_your\_cache](https://en.wikipedia.org/wiki/Wikipedia:Bypass_your_cache).
+[instructions to bypass your browser cache](https://en.wikipedia.org/wiki/Wikipedia:Bypass_your_cache).
 
 
 ::::::::::::::::::::::::::::::::::::::::::::::::::

diff --git a/instructors/checkout.md b/instructors/checkout.md
@@ -61,8 +61,8 @@ If you find something that you know how to fix by changing the code of the lesso
 and comment on existing PRs. We will not cover the details here, but there is [a
 community-contributed guide on how to create a PR][github-guide] that can help.
 
-Each lesson repository has a document, named `CONTRIBUTING.md`, that outlines contribution guidelines. The one for this repository
-is [here][contributing]. Maintainers for each repository may choose to customize their own guidelines.
+Each lesson repository has a document, named `CONTRIBUTING.md`, that outlines contribution guidelines.
+You can read [the contribution guidelines for this repository][contributing]. Maintainers for each repository may choose to customize their own guidelines.
 
 ### Add Your Lesson Contribution to Your Carpentries Record
 
@@ -77,7 +77,7 @@ For this checkout task, please:
 
 If you have difficulty submitting your lesson contribution in AMY, please email us at [[email protected]](mailto:[email protected]) -- we would like to know about your problem and can help to get you logged in. However, if you would like to submit your contribution before you receive a response from us, you can use [this form](https://docs.google.com/forms/d/e/1FAIpQLSeMBOj5Rdh8Mgk0ebRbeRyHhGHKbItdft6avWuEzmeg8CgWbA/viewform) as an alternative.
 
-You can track your progress by [logging into AMY here](https://amy.carpentries.org).
+You can track your progress by [logging into AMY](https://amy.carpentries.org).
 
 ### Alternatives to GitHub
 

diff --git a/instructors/instructor-notes.md b/instructors/instructor-notes.md
@@ -57,7 +57,7 @@ Details about the Instructor Trainer role including the application process, dut
 ### Immediately after the event
 
 - Send a list of those who completed the training to checkout@carpentries.
-- Send an email to trainees thanking them for participating and linking to [checkout checklist][checkout-checklist]. See template [here][post-template].
+- Send an email to trainees thanking them for participating and linking to [checkout checklist][checkout-checklist]. See [an email template to thank the participants][post-template].
 - Review survey results and prepare to discuss at upcoming [Trainers discussion meeting][trainer-pad].
 - File any relevant issues or PRs to the [instructor training repo][training-repo].
 
@@ -157,8 +157,8 @@ account for yourself for free. This personal account will be able to attend the
 About a week before your event, you will be given login credentials for a Carpentry account. Alternatively, if no
 one has yet claimed "host" in your session, you can click "claim host" next to your name in the Participants list;
 you will be asked for a 6-digit host key, which you can find [in this message](https://carpentries.topicbox.com/groups/trainers/T3ec157cc9a3d1833/zoom-host-code).
-See [the explanation here][zoom-host-key] for step-by-step instructions on how to
-claim host in Zoom Rooms using the host key.
+See [the explanation for step-by-step instructions on how to
+claim host in Zoom Rooms using the host key][zoom-host-key].
 
 This account will be the host for the event and will have extra privileges including the
 ability to mute participants and assign participants into breakout rooms. Decide ahead of time with your co-Trainer(s) who will log-in with/claim these credentials. The host

diff --git a/learners/checkout.md b/learners/checkout.md
@@ -61,8 +61,8 @@ If you find something that you know how to fix by changing the code of the lesso
 and comment on existing PRs. We will not cover the details here, but there is [a
 community-contributed guide on how to create a PR][github-guide] that can help.
 
-Each lesson repository has a document, named `CONTRIBUTING.md`, that outlines contribution guidelines. The one for this repository
-is [here][contributing]. Maintainers for each repository may choose to customize their own guidelines.
+Each lesson repository has a document, named `CONTRIBUTING.md`, that outlines contribution guidelines.
+You can read [the contributing guidelines for this repository][contributing]. Maintainers for each repository may choose to customize their own guidelines.
 
 ### Add Your Lesson Contribution to Your Carpentries Record
 
@@ -77,7 +77,7 @@ For this checkout task, please:
 
 If you have difficulty submitting your lesson contribution in AMY, please email us at [[email protected]](mailto:[email protected]) -- we would like to know about your problem and can help to get you logged in. However, if you would like to submit your contribution before you receive a response from us, you can use [this form](https://docs.google.com/forms/d/e/1FAIpQLSeMBOj5Rdh8Mgk0ebRbeRyHhGHKbItdft6avWuEzmeg8CgWbA/viewform) as an alternative.
 
-You can track your progress by [logging into AMY here](https://amy.carpentries.org).
+You can track your progress by [logging into AMY](https://amy.carpentries.org).
 
 ### Alternatives to GitHub