Scientific Programming with Python: Assignment Peer Feedback/Grading Template

Minh Truong, Erik Autenrieth, Abanoub Abdelmalak and Karl N. Kirschner, Ph.D.

Department of Computer Science
University of Applied Sciences Bonn-Rhein-Sieg
Grantham-Allee 20, 54757 Sankt Augustin, Germany

---

This repository contains the HTML and JSON documents needed for providing homework feedback for the course Scientific Programming with Python given at the University of Applied Sciences Bonn-Rhein-Sieg. The HTML document can be given to students for giving peer feedback, or to graders for their evaluation of homework assignments. A grader can either 1) use the form directly on GitHub (https://karlkirschner.github.io/scipro_assignments_grading/), or clone and open the index.html file on their local browser (note: the content, given as JSON files, should be automatically grabbed from this repository).

Content

• index.html file: the HTML document that generates the web page. One can use the set const debug = true and copy-and-paste the JSON content to develop ideas locally, before pushing it to GitHub (thus, allowing the development of the ideas to be faster).
• references.json file: the main JSON file that will link to the other JSON files within the criteria folder
• criteria folder: contains JSON files developed for specific library/assignment-specific feedback
• functions folder: javascript files that are needed for the webpage

Student Usage: Students who give peer feedback should file in the ID of the student whose work they are critiquing, fill out the form as appropriate, and then save the JSON and TXT files. A saved JSON file will allow you to continue working on the feedback at a later time.

Grader Usage: Graders should open the HTML document (e.g., Firefox index.html) and click on the appropriate feedback items. At the end of the document, there is a Generate button, which will take the clicked items and compile the text into the bottom window. One can then copy-and-paste the feedback as desired. One can also save the form as a JSON and TXT file. The JSON file can be given to the principal instructor, while the text files can be given to the students themselves. Upon a new feedback (i.e., another student's solution), click the Reset button at the top. The floating Grading window can tally the student's grade as you work through their assignment solution.

Modifying: The following information is for those who want to use this as a template in their courses. You will need to modify the links link in the following files to reflect your own repository and criteria JSON files:

• the references.json file contains multiple links to this GitHub repository
• the grading_template_json.html file contains one link to this GitHub repository
• the folder criteria contains the feedback a) suitable for all assignments (general.json) and b) specific library/assignments (*.json)

Browsers Tested: Mozilla Firefox and Chrome

Partial Funding: HEP 3 Funding Program for Open Educational Resources

Contribution

1. Karl N. Kirschner - template conceptualization, feedback content and maintenance
2. Abanoub Abdelmalak - template conceptualization and HTML prototyping
3. Minh Truong - conceptualization and coding JSON components
4. Erik Autenrieth - conceptualization and coding JSON components