Basic accessibility changes

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
 

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 [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?  

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 [https://miku.github.io/activememory/][memory-test].
 
 What was your score? If you are comfortable, share your answer
 in the Etherpad.

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 [https://carpentries.org/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?
 

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 as a group [https://www.youtube.com/watch?v=-ApVt04rB4U][bad-teaching-video]
 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)
 
 This exercise should take about 10 minutes.
 

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: [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?
@@ -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](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

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 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.

episodes/20-performance.md

@@ -27,7 +27,8 @@ process of observing and giving feedback, and to make changes to how we teach ba
 
 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
+  [https://carpentries.github.io/instructor-training/demos\_rubric/](demos_rubric.md).
+  (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.

episodes/21-management.md

@@ -258,7 +258,8 @@ We encourage you to **discuss an approach to managing Code of Conduct violations
 
 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)
+   [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)(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?

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
 

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

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