Adding Taimur's changes #20
Conversation
There was a problem hiding this comment.
@taimurkashif I accidentally prematurely merged the PR. All my feedback is here: #18
Also, after consulting with some of the directors, we decided it would be best to add a section on how to convert a Medium tutorial article into activity cards. You wouldn't have to develop the whole thing, just provide guidelines on how to develop activity cards with relevant examples and visuals from one of the workshops from the Airtable link I sent you.
Can you pick a workshop from the Airtable link I shared with you? please let me know what workshop you will use to demonstrate in this documentation.
Sorry about the inconvenience!
| * Use plenty of images that presenters can use to explain concepts, helping minimize word count on each respective Markdown file/slide. These images do not necessarily need to be a part of the activity or lab themselves, but they should be related to the content on the slide. | ||
| * Integrate code snippets as neccessary. | ||
| * Try not to have more than one card from an activity/lab represented on a single Markdown file (which corresponds with a slide). If you find yourself doing this, it probably means that you are including too much text or not adequately presenting each card. | ||
|
|
There was a problem hiding this comment.
I think you could add the link to the documentation I created about developing workshops from cards. Then the bullet point can be shorter and more brief.
| ## Workshop Format | ||
|
|
||
| These workshops are typically created in the form of slides/ presentations along with an interactive activity in which students can apply the knowledge that they gained throughout the presentation. Note that this interactive activity is **NOT** of the form of a "quiz" game, but rather, is an activity which allows students to critically think about and apply what they have learned (See [How to Contribute to Workshops](./How-to-contribute-to-workshops.md) for more details). | ||
|
|
There was a problem hiding this comment.
I think the link here is not very necessary, since you did not talk about what activities are in the how-to-contribute-to-workshops.md. Maybe link an example of a workshop slides instead?
* Integrated Kevin and Kathy's comments into README.md and how-to-contribute-to-workshops.md
* Added documentation of Converting Medium Tutorial Articles to Markdown Files
No description provided.