The Technical Facilitator will deliver the content in the /01_materials/slides directory. You are encouraged to live code with participants during live sessions. Please ensure that live coding files are uploaded to a new directory called /live_code under /04_cohort_three in this repository using a new branch. Please open a pull request for it to be merged.
The module is organized into 3 main directories:
- Slides
- Assignments
- Homework
The /01_materials/slides directory contains the live learning session slides.
The /02_activities/assignments contains assignments participants should submit for evaluation as complete or incomplete. The assignments measure a participant's achievement of the learning outcomes, and help technical facilitators determine if a participant has successfully completed the learning module.
The /02_activities/homework directory contains homework participants can complete to further develop and practice the skills covered in a learning module. Homework is optional, but participants are encouraged to complete as much as they can.
The focus of the live learning session is to introduce participants to basic bash commands such as cd and pwd, as well as creating files using touch and directories using mkdir. The module also introduces intermediate commands like rm, how to recursively remove files from a nested directory, and how to make copies or move files using mv.
Note: If someone wants to open up the "manual", recommend they use the man command.
The assignment for this week is to have participants find the secret password by navigating directories and files.
Technical Facilitators are encouraged to introduce assignments as early as possible in the learning module. The Technical Facilitator should describe the assignment to participants and explain how the topics covered in the module will equip them with the knowledge and skills to complete the assignment.
Participants are expected to complete the assignment by the end of the first week. They will deliver the assignment by opening a pull request on their copied repo. The participants will also add a Learning Support Staff as a reviewer indicating they delivered a completed assignment, and it is ready to be evaluated as complete or incomplete.
The criteria for a complete or incomplete is if all parts of the program are working, and nothing in the code is broken. For some assignments, a rubric is provided outlining the criteria needed to assess an assignment as incomplete.
If the participant's solution works, then their assignment should be assessed as complete! Technical Facilitators and the Learning Support Staff should focus on providing constructive feedback to participants who need to improve their code. If the solution does not work, then the assignment is incomplete. Facilitators should provide constructive feedback on their existing code, and guide them to get their solution working.
Feedback should be given through the pull request a participant has made. Technical Facilitators are encouraged to allow participants to make revisions if needed. In order to maximize learning, feedback should be constructive, and specific.
Live Learning Sessions: A Live Learning Session is a synchronous period of time, lasting up to 2.5 hours, where the Technical Facilitator will facilitate and deliver the content and learning outcomes online through Zoom. Participants are encouraged to participate and ask questions as they learn. 10 minute breaks are encouraged once per hour.
Work Period: A Work Period is an asynchronous period of time, lasting up to 3 hours. Participants will work on assignments and/or homework during this block of time. Learning Support Staff are to be present online through Zoom to assist participants and answer any questions they may have. As work periods are asynchronous and flexible, participants can choose to work on their own time. However, it is encouraged that they work during the block of time when a Learning Support Staff is present.
Assignments: An Assignment is work assigned as part of the learning modules. They provide an opportunity for participants to integrate and synthesize what they have learned throughout the week to meet the set learning outcomes.
This script is designed to convert Markdown files located in a specified folder into slide presentations using Marp CLI, allowing for the generation of either HTML or PDF formats based on user input. It includes an option to apply a custom CSS theme to the slides by specifying a theme path. The script also provides a help function detailing its usage, options, and examples for convenience. It ensures the necessary directories exist, validates the presence of Marp CLI on the system, processes each Markdown file found in the specified directory, and outputs the generated slides into a designated output folder, displaying the status of each operation and a completion message. The only configuration needed is to set where the md files are and where you would like the pdf/html files to be placed.