Home

##Welcome to the virtual-classroom wiki!

virtual-classrom is a tool for working using GitHub classrooms in group sessions at the university. To see the diffenrent options you can simply run

python start_group.py -h

To read more about it please see parameters.

##Workflow A suggested workflow for virtual-classroom.

###Get info about students First step is to get a list of the students with email and github username. If you use this google form (important that the order of the questions stays the same) and rename your spreadsheet with responses to be called the same as your course in default_parameters.txt. Then you can run

./scripts/get-info-google-spreadsheet.py

and it will get all the information in the correct format in the folder Attendance. Now you only need to maintain database on google drive.

###Initialize Now it's time to make a repo for each student in the course. Now we can use another script

./scripts/copy-attendance-file.py

This gives you a file 'Attendance/-YYYY-MM-DD.txt'. You now have to open this file and register that all students are pressent (use search and replace). Now run

python start_group.py --i True

This will only initialize the class so it will only create repositories for thoes how does not have it.

Note: Running this script will send out an email to each student, you should have a look at message_new_student.rst first.

###Start a group Now that the students have worked and pushed some exersices it is time to set up groups such that the students can review the code. Now you simply run

./scripts/copy-attendance-file.py

Register the students that are pressent and run

python start_group.py

Note: Running this script will send out an email to each student, you should have a look at message_collaboration.rst first.

After the students have pushed some feedback or are done you can rewoke the access by running

python start_group.py --e True

###Getting the feedback The groups session is over and you want to read through the feedbacks:

python start_group.py --F True

During this program you will be asked to give the name of the project and what the feedbackfiles are called. This will give you a folder _all_feedbacks// under this it's four interesting files.

1. Folder with all students that passed.
2. Folder with all students that did not get approved.
3. A file with all students what have not gotten any feedback.
4. A file with all students that may have cheated.