Submission Architecture Decision Record (ADR)

Submission Architecture Decision Record (ADR)#

Status: DRAFT

12/1/24

Context#

Students are currently directed to export PDFs and submit via Brightspace. This has various tradeoffs — see the comparison below. I think there might be a better way.

Considerations#

  • The assignments are largely/increasingly open-ended.

  • There’s more need for manual line-by-line feedback than auto-grading.

Nice-to-haves#

  • Auto-grading

  • Plagiarism detection

  • Minimal/foolproof workflows for:

Options#

PDF export#

If sticking with PDFs, they can be exported from Google Colab:

Option

Pros

Cons

Directly, via nbconvert

Single click, in theory

Fragile

As HTML, then Save as PDF

Higher fidelity

Extra steps; Plotly doesn’t re-draw on print, so need to resize window or set dimensions to ensure it fits

Decision#

Notebook + Python files through Gradescope

Consequences#

TODO