remark

A DSL for marking student work https://github.com/oleks/remark#readme

Latest on Hackage:0.0.0.0

This package is not currently in any snapshots. If you're interested in using it, we recommend adding it to Stackage Nightly. Doing so will make builds more reliable, and allow stackage.org to host generated Haddocks.

BSD3 licensed by Oleks
Maintained by oleks@oleks.info
#+TITLE: remark — a DSL for marking student work

#+ATTR_HTML: title="License: BSD 3-Clause"
[[LICENSE][file:https://img.shields.io/badge/License-BSD%203--Clause-blue.svg]]
#+ATTR_HTML: title="Travis CI Status"
[[https://travis-ci.org/oleks/remark][file:https://travis-ci.org/oleks/remark.svg]]

When judging student performance, it is useful to have both small, composable,
quantitive judgements, and qualitative remarks. This makes both spreadsheets
and mere text-files ill-suited for marking student work. Although
[[http://orgmode.org/][org-mode]] can solve this problem to a great extent, it
becomes a heavy tool in the light of having to mark hundreds of students in a
distributed fashion. With org-mode, everything is in one file, while global,
intra-student statistics are not needed until all the students have been fully
marked.

* Design Goals

1. One human-readable/editable file per student.
2. Export options to spreadsheet-formats.
3. git-friendly file format.
4. Synchronization options with Dropbox and/or Google Drive.

Goal 4 is not necessarily related to remark, but is related to marking student
work with external examiners, who are not always willing to use more explicit
version-control systems, such as git.

* Files and Directories

#+BEGIN_SRC
oleks-1.mrk
oleks-2.mrk
oleks-3.mrk
oleks/4.mrk
oleks/5.mrk
oleks/6.mrk
#+END_SRC

* Syntax

A =.mrk= file is a list of judgements. A judgement is a header, with a title,
set points, and maximum points, followed by some comments.
Used by 1 package:
comments powered byDisqus