Guide for students Ⓢ and instructors Ⓣto choosing a workflow and finding related documentation
Depending on how familiar students are to Version Control technologies such as Git, different workflows may fit best the strategy used to distribute coding materials and assignments.
Ⓢ① Students in classes that are new to programming and/or version control
Related sections in the documentation (look for ① and Ⓢ in the section title):
Ⓣ① Teachers looking for a simple way to distribute materials to students who will NOT be introduced to git.
There are two options:
Direct Upload:
This simple workflow assumes no git knowledge from the student nor the instructor. Notebook files are shared via CANVAS and directly uploaded to JupyterHub
Direct File Upload Workflow
Related sections in the documentation (look for Ⓣ ① in the section title):
Using this workflow, teachers have the ability to generate a smart link that pulls the materials automatically for students into their JupyterHub. If you are a teacher using this method, you will need basic familiarity with git and github.
Workflow when synching content using a (special) link
ⓉⓈ② Teachers and Students using Git/GitHub and GitHub Classroom
Using Git and GitHub to distribute your materials encourages best practices for software development and additionally adds versioning to changes made to the source code, allowing students to revert to prior versions if necessary. If you will be using Git, we recommend using GitHub Classroom to help automate the process.
Related sections in the documentation (look for ② in the section title):
