| #summary Various work items in Melange | |
| #labels Phase-Requirements,Contents-Draft,Importance-Details | |
| 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] |