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
@@ -25,9 +25,9 @@ exercises: 15
 :::::::::::::::::::::::::::::::::::::::instructor
 In an online training, ensure that captions are turned on.
 
-
 :::::::::::::::::::::::::::::::::::::::::::::::::::::::
 
+
 ::::::::::::::::::::::::::::::::::::::  discussion
 
 ## Pronouns and Names

diff --git a/episodes/02-practice-learning.md b/episodes/02-practice-learning.md
@@ -210,7 +210,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 [Exclidraw](https://excalidraw.com) [https://excalidraw.com](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]
+Try a short [test of working memory][memory-test] [https://miku.github.io/activememory/][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 Carpentries Core Values][core-values] [https://carpentries.org/about-us/#our-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?
 
@@ -334,7 +334,7 @@ being involved in the development of this content, please let us know! Contribut
 at the top), though our [\#accessibility channel][slack-accessibility] on [The Carpentries Slack][slack-join], or by emailing [[email protected]](mailto:[email protected]).
 
 [glossary]: https://www.diversity.pitt.edu/education/glossary-terms
-[core-values]: https://carpentries.org/values/
+[core-values]:  https://carpentries.org/about-us/#our-values
 [handbook-host-template]: https://docs.carpentries.org/resources/workshops/email_templates.html
 [sketchplanations-curb-cuts]: https://sketchplanations.com/the-curb-cut-effect
 [CAST]: https://udlguidelines.cast.org

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
-and then give feedback on it.
-[https://www.youtube.com/watch?v=-ApVt04rB4U][bad-teaching-video]
+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) [https://www.youtube.com/watch?v=jxgMVwQamO0](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](checkout.md)
+In small groups, read and discuss one of [the three checkout procedures](checkout.md) [https://carpentries.github.io/instructor-training/checkout/index.html](checkout.md).
 Make notes in the Etherpad:
 
 - What points do you think it is most important or helpful for people to remember?

diff --git a/episodes/15-carpentries.md b/episodes/15-carpentries.md
@@ -236,8 +236,8 @@ Maybe this instructor training has inspired you to go home and write your
 own fantastic lesson!  If you would like to model it after the Software, Data and
 Library Carpentry lesson format, you can find two Workbench lesson templates available:
 
-- [Markdown](template-md): this template is suitable for lessons that serve static content
-- [RMarkdown](template-rmd): this template is suitable for lessons that include executable R code
+- [Markdown][template-md]: this template is suitable for lessons that serve static content
+- [RMarkdown][template-rmd]: this template is suitable for lessons that include executable R code
 
 Any lesson that uses The Carpentries lesson templates follows our [Code of Conduct][coc], 
 and is licensed either [CC-BY][cc-by] or [CC-0][cc-0] can be hosted in [The Carpentries Incubator][carpentries-incubator].
@@ -307,8 +307,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 communication channels][connect-page] you want to stay involved with: [https://carpentries.org/connect/][connect-page]
 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/instructors/instructor-notes.md b/instructors/instructor-notes.md
@@ -156,8 +156,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].
 
 
 ### General tips for online training: