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 setconst 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 foldercriteria
folder: contains JSON files developed for specific library/assignment-specific feedbackfunctions
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
- Karl N. Kirschner - template conceptualization, feedback content and maintenance
- Abanoub Abdelmalak - template conceptualization and HTML prototyping
- Minh Truong - conceptualization and coding JSON components
- Erik Autenrieth - conceptualization and coding JSON components