| #summary Overview of the various work items in Melange |
| #labels Phase-Requirements,Contents-Draft |
| |
| The [SoCOverview SoC framework] implements workflows that pass |
| [ProposalModel Proposals], [TaskModel Tasks], and other WorkItems from |
| one [UserModel user] to another. These work items can be created, |
| [WorkViews viewed], and manipulated by users. |
| |
| Each work item is represented in the |
| [http://code.google.com/appengine/docs/datastore/ Datastore] by an entity |
| model. WorkModels summarizes the relationships between these models. |
| |
| == Work == |
| |
| The Work item is a basic item from which all other work items derive. This |
| item is represented in the [http://code.google.com/appengine/docs/datastore/ |
| Datastore] by [WorkModel Work entities]. |
| |
| == Proposal == |
| |
| The most basic derived Work is the [ProposalModel Proposal]. A Proposal |
| contains details related to what is being proposed, such as a description. |
| Proposals may be created by either Reviewers or Contributors, depending on the |
| actual workflow of the Program. See the [WorkItems#Task Task description] for |
| more details. |
| |
| == Review == |
| |
| The [ReviewModel Review] is an abstract derived Work that is not used |
| directly, but is instead used to "adorn" [WorkItems#Proposal Proposals] and |
| [WorkItems#Task Tasks]. |
| |
| == Survey == |
| |
| A [SurveyModel Survey] is a "sub-class" of a [WorkItems#Review Review] (but is |
| implemented as more of an envelope-letter arrangement). That is, a |
| [WorkItems#Review Review entity] "contains" (among other possibilities) a |
| reference to a [SurveyModel Survey]. |
| |
| _*TODO: perhaps Review and Survey should be combined, with a generic |
| one-question survey available for a free-text comment. For that matter, |
| perhaps the as-yet-defined Commenting and Scoring systems should just use the |
| combined Review/Survey result.*_ |
| |
| == Task == |
| |
| A [TaskModel Task] is a [WorkItems#Proposal Proposal] that has been "promoted" |
| to the state of a task underway (and eventually completed, aborted, discarded, |
| rejected, etc.). Proposals are converted to Tasks when claimed by |
| Contributors (in the case of Reviewer-created Proposals), or when selected by |
| Reviewers (in the case of Contributor-created Proposals). |
| |
| ---- |
| _Copyright 2008 Google Inc._ |
| _This work is licensed under a_ |
| [http://soc.googlecode.com/svn/wiki/html/licenses/cc-by-attribution-2_5.html Creative Commons Attribution 2.5 License]. |
| [http://creativecommons.org/licenses/by/2.5/ http://soc.googlecode.com/svn/wiki/html/licenses/cc-by-2_5-88x31.png] |
