workshop delivery instructions

README.md

@@ -1,7 +1,23 @@
+## Workshop Instructional Materials
+
+Welcome to the workshop-o-matic, built by Cloud Advocates in partnership with Microsoft Student Ambassadors. In this repo, you'll find files to help you host your own workshop using content from this library.
+
+> Use the enclosed [Cheat Sheet](./cheat-sheet.md) to organize your workshop delivery
+
 ## Prepared workshops
 
 Workshops that are ready to be used
 
 | **Workshop Title**              | **Author(s)**  | **Duration** | **Link**                                  |
 | ------------------------------- | ----------- | ------------ | -------------------------------------- |
 Build a Machine Learning Model |Christopher Harrison | 1 hour | [Custom Vision Workshop](./custom-vision-workshop)
+
+---
+
+## Slides and courses on how to teach and mentor effectively
+
+[Slides on how to mentor](https://github.com/FrontEndFoxes/art/blob/main/frontend-foxes-mentor-training.pdf) from Front-End Foxes School
+
+[LinkedIn Learning Course](https://www.linkedin.com/learning/teaching-techniques-developing-curriculum/welcome?autoAdvance=true&autoSkip=false&autoplay=true&resume=true&u=3322) on how to develop curriculum
+
+[LinkedIn Learning Course](https://www.linkedin.com/learning/presenting-technical-information-with-stories/storytelling-for-technical-presentations?autoAdvance=true&autoSkip=false&autoplay=true&resume=true&u=3322) on how to present technical topics with stories

SUPPORT.md

@@ -1,13 +1,3 @@
-# TODO: The maintainer of this repo has not yet edited this file
-
-**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project?
-
-- **No CSS support:** Fill out this template with information about how to file issues and get help.
-- **Yes CSS support:** Fill out an intake form at [aka.ms/spot](https://aka.ms/spot). CSS will work with/help you to determine next steps. More details also available at [aka.ms/onboardsupport](https://aka.ms/onboardsupport).
-- **Not sure?** Fill out a SPOT intake as though the answer were "Yes". CSS will help you decide.
-
-*Then remove this first heading from this SUPPORT.MD file before publishing your repo.*
-
 # Support
 
 ## How to file issues and get help  
@@ -16,10 +6,8 @@ This project uses GitHub Issues to track bugs and feature requests. Please searc
 issues before filing new issues to avoid duplicates.  For new issues, file your bug or 
 feature request as a new Issue.
 
-For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE 
-FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER
-CHANNEL. WHERE WILL YOU HELP PEOPLE?**.
+For help and questions about using this project, please contact Jen Looper via Teams or tag me in the issues.
 
 ## Microsoft Support Policy  
 
-Support for this **PROJECT or PRODUCT** is limited to the resources listed above.
+Support for this Workshop Template is limited to the resources listed above.

cheat-sheet.md

@@ -0,0 +1,26 @@
+# Workshop Cheat Sheet
+
+Here are the steps to take to host a workshop:
+
+## Planning phase
+
+1.  Clone this repo and select the workshop that you will present. If you would like to translate and/or localize an existing workshop, please feel free to do so, and PR your changes, preserved in the /translations folder, back to this library for review.
+
+## Logistics phase
+
+1. Invite your students to the workshop held on Teams, optionally using text from your [workshop designer](../template/workshop-designer.md) file to explain expected student takeaways. You can use [this template](https://www.canva.com/design/DAEuDXXR9us/EdQZLkVpknPAzSRD4fSxyw/view?utm_content=DAEuDXXR9us&utm_campaign=designshare&utm_medium=link&utm_source=sharebutton&mode=preview) to design a poster about your session. There are also posters and marketing materials on Teams in the Student Ambassador tenant for use to promote your workshop.
+1. Gather a group of mentors and assign them groups of students if you will be teaching a large group. Meet with the mentors prior to the workshop, and walk through the suggested [mentor training](https://github.com/FrontEndFoxes/art/blob/main/frontend-foxes-mentor-training.pdf)
+
+## Delivery phase
+
+1. Hold the workshop on Teams, **keeping count of attendees**.
+1. Start with slides, giving a presentation to introduce yourself and explain what students will discover.
+1. After the presentation, walk through the workshop's root README files, explaining the milestones.
+
+## Feedback phase 
+
+1. Ask students in the workshop to fill out [this survey](https://forms.office.com/r/MdhJWMZthR), linked at the bottom of the workshop page. 
+1. Fill in a [survey to catalogue your own experiences](https://forms.office.com/r/thfwmD0USG) as a workshop instructor using this form. We are eager to hear any feedback about the workshop, including your experience as a teacher, your mentors' experiences, and any suggestions from any participant on to improve the workshop.
+1. Log your activity via the MLSA program tools.
+
+Have fun! and Thank you!

custom-vision-workshop/translations/README.md

@@ -0,0 +1 @@
+In this folder, you can find translations of existing workshops in their appropriately-named folders.

custom-vision-workshop/translations/es/README.es.md

@@ -0,0 +1 @@
+Placeholder for Spanish translations

pull_request_template.md

@@ -0,0 +1,12 @@
+## Use this template to add a workshop to this repo. Add the following items:
+
+- [ ] Your workshop design document, filled in with some details about your proposed workshop including its title and the three stages in the designer delineated.
+
+- [ ] A README.md file that describes the steps of the workshop. You can include a video explanation as an embed.
+
+- [ ] Powerpoint Slides for the workshop.
+
+- [ ] The workshop's solution in the `/solution` folder.
+
+A reviewer will be assigned to the workshop and will be work with you to shape it for production. Thank you for your contribution!
+