hw1.project.json holds project data and is written centrally for every hw. Comments and grades are later written to this file as well. student_data.json is reused for every assignment.

hw1.project.json

{
    "files": [
        {
            "name": "something.json",
            "questions": [
                {
                    "name": "someQuestion",
                    "tag": "let someQuestion",
                    "points": {
                        "style": 7,
                        "testing": 8
                    }
                },
                {
                    "name": "anotherQuestion",
                    "tag": "let anotherQuestion"
                }
            ]
        }
    ],
    "default_grades": {
        "style": 10,
        "testing": 5
    },
    "final_grades": {
        "final_style": "some formula?"
    },
    "students": [
        {
            "email address": "bfranklin@seas.upenn.edu",
            "final_style": 13,
            "files": [
                {
                    "name": "something.ml",
                    "questions": [
                        {
                            "name": "someQuestion",
                            "points": {
                                "style": 8,
                                "testing": 4
                            },
                            "issues": [
                                {
                                    "name": "Spaces for tabs",
                                    "description": "Make sure you're using spaces instead of the tab character",
                                    "severity": 2
                                }
                            ]
                        }
                    ]
                }
            ],
            "email_text": "Dear Benjamin..."
        }
    ],
    "email_template": "Dear %NAME%..."
}

issue_templates.json

{
    "issues": [
        {
            "name": "Spaces for tabs",
            "description": "Make sure you're using spaces instead of the tab character",
            "severity": 2
        }
    ]
}

student_data.json

{
    "students": [
        {
            "email": "bfranklin@seas.upenn.edu",
            "name": "Benjamin"
        },
        {
            "email": "adams@sas.upenn.edu",
            "name": "John"
        }
    ]
}

In the project file, you can either specify point breakdowns per-problem or let the app use the default_grades instead.