UIncorporate feedback

Author: alisondy

mentoring/programs/contributor-workshop/README.md

@@ -12,7 +12,7 @@ The Contributor Workshop is currently in development, and has not been released
 
 You can view the live state of the site by going to [https://workshop--kubernetes-contributor.netlify.app/docs/workshop/](https://workshop--kubernetes-contributor.netlify.app/docs/workshop/)
 
-The umbrella issue tracking getting this initiative available to the public is [#4830 in kubernetes/community](https://github.com/kubernetes/community/issues/4830).
+The umbrella issue tracking getting this initiative available to the public is [kubernetes/community#4830](https://github.com/kubernetes/community/issues/4830).
 
 ## Getting Involved
 

mentoring/programs/contributor-workshop/resources/guides/README.md

@@ -8,9 +8,11 @@ This folder contains guides and information on how to contribute to the Contribu
 
 The workshop is divided into segments. These segments exist as individual pages in the ``content/en/docs/workshop`` directory on the branch ``workshop`` in the ``contributor-site`` repo.
 
-Each of these segments contain
+Each of these segments contain:
+
 * Written information
 * One or more Exercises
+
 and may contain a video version of the written information.
 
 ## Guides
@@ -25,11 +27,15 @@ How to structure, record, upload and update video guides associated with worksho
 
 ## Glossary of Terms
 
-Segment
-  A page in the workshop directory covering a particular section of the Contributor Workshop.
-  This page may contain
-  * Written information
-  * Video version of the segment
-  * Hands on exercise
-Exercise
-  Step by step, hands on activity within a segment.
+### Segment
+
+A page in the workshop directory covering a particular section of the Contributor Workshop.
+This page may contain
+
+* Written information
+* Video version of the segment
+* Hands on exercise
+
+### Exercise
+
+A step by step, hands on activity within a segment.