Changes between Version 19 and Version 20 of BossaOverview

Timestamp:

Jul 30, 2008, 10:23:07 AM (16 years ago)

Author:

davea

Comment:

--

BossaOverview

@@ -29 +29 @@
  * You (the project) define the '''policies''' by writing PHP functions; you need to have basic knowledge of PHP to use Bossa.
 
-The software structure of Bossa is shown here:
+The software structure of Bossa is summarized here:
 
 [[Image(bossa.png)]]
@@ -44 +44 @@
 
 The data needed to display a job may include various filenames, numbers, etc.
-This info is stored in a PHP structure
-that you create when you generate the job.
-Bossa stores this in a serialized (textual) from in the database.
+This info is stored in an '''opaque data''' structure,
+an arbitrary PHP structure
+that you supply when you create the job.
+Bossa stores the opaque data in a serialized (textual) from in the database.
 When a job is to be displayed to a volunteer,
-Bossa calls your "job display function", passing it this structure.
+Bossa calls your one of your callback functions (job_show()),
+passing it the opaque data.
 
-Similarly, the results of a completed job are stored in a PHP structure
+Similarly, the results of a completed job are stored in an opaque data structure
 defined by your application.
 
@@ -94 +96 @@
  * For more complex tasks, ability could have arbitrarily many dimensions.
 
-Bossa lets you associate an arbitrary PHP structure with each volunteer.
+Bossa lets you associate an opaque data structure with each volunteer.
 This can be initialized and updated however you want.
 
@@ -103 +105 @@
 == Use of experts ==
 
-There are various way in which "experts" might be used.
+There are various ways in which "experts" might be used.
 Two general possibilities:
 
@@ -115 +117 @@
 volunteers can be assigned integer '''levels'''.
 Each job has a vector of priorities, one per level.
-Jobs are sent to a given volunteer in order of decreasing level-specific
-priority.
+Jobs are sent to a given volunteer in order of decreasing level-specific priority.
+
+For example, suppose you want to use experts to resolve jobs for which
+N non-experts have failed to reach a consensus.
+Use level 0 for non-experts, 1 for experts.
+In your '''job_finished()''' callback function,
+check for the case of N instances without consensus,
+and set the priority for level 1 to 2.
+
+In this scenario, experts will always get unresolved jobs if they are available;
+otherwise, they will get regular jobs.