Skip to content
This repository has been archived by the owner on Sep 26, 2019. It is now read-only.

Terms and Keywords

wlla edited this page Aug 20, 2015 · 4 revisions

annotation

A record of the user's response to a given task; for example, a mark that designates a region to be transcribed, the answer to a question, in the Mark and Transcribe workflows, respectively.

classification

A record of a volunteer’s responses to a given subject’s workflow; contains the subject id and annotation.

mark

Task requiring users to annotate the location of specific fields. A variety of mark tools are available in the config and should be selected based on the field being marked.

subject

A uniquely identifiable media document, usually containing an image, that users are asked to work on; contained in a JSON object along with data that includes a URI, classification count (see classification), and any parent subjects.

Depending on the workflow, subjects may generate child subjects with their own workflow. A typical example is as follows: Users may annotate a primary subject by placing marks on regions that require subsequent transcription. Once a mark is submitted, it becomes a child subject with its own workflow. In this case, the secondary workflow could be a series of transcription tasks. In theory, the child subjects can continue to generate additional child subjects ad infinitum, but keep in mind that the initial goal can take exponentially longer to complete.

  • primary The initial subject that users are asked to work on; by default belongs to the Mark workflow.
  • secondary Immediate descendant of the primary subject; by default belongs to the Transcribe workflow.
  • tertiary Immediate descendant of the secondary subject; grandchild of the primary subject; by default belongs to the Verify workflow.
  • k-ary Additional descendants (quartenary, etc.) of the primary subjects; while, supported, their use is strongly discouraged unless a custom project demands it.

task

A general task component which is passed tools or several specific tasks that are pre-populated with tools? NOTE: this is a technical term that is more specific than simply "something that needs to get done."

tool

An user interface component that enables a volunteer to execute a given task.

transcribe

The task asking users to transcribe the text on the page for a particular field, annotated during the mark task phase.

verify

The task asking users to compare two transcriptions of the same field and select the most accurate.

workflow

Represents the series of marking, transcribing, or verification tasks, both ordered and unordered, for a set of subjects; there is a one-to-one correspondence between a subject and a workflow.