Admin: Creating new page with Category: Docu

2014-08-29T21:19:30Z

Creating new page with Category: Docu

New page

[[Category:Docu]] <table id="wt-documentation" cellspacing="0" cellpadding="0"> <tr> <td class="content">
This page explains how to '''[[#Create Plain Task|create new tasks]]''' and how to
'''[[#Add Task Attributes|add task attributes]]'''. It also explains how to '''[[#Add Additional Properties|add additional properties]]'''
and how to '''[[#Add Content| add new content]]'''. Remember to login before creating an new task.

==Create Plain Task==
A new '''root task''' can be created via the '''[[Exploring Tasks#Task Explorer|Task Explorer]]''' and '''new subtasks''' via the
'''[[Exploring Tasks#Subtask Explorer|Subtask Explorer]]'''. Start by clicking on the plus button, an input
field appears. Type the name of the new task and press enter to confirm. If you have an expertise keyword selected when you create a new
root task, then the system will automatically add that expertise keyword to the task. If the My Tasks tab is selected when you add a new task, the system will set you up as its owner.<br/>
[[File:Docu_Create_CreateTask1.png|550px]]<br/><br/>
[[File:Docu_Create_CreateTask2.png|200px]]<br/>
[[File:Docu_Create_CreateTask3.png|450px]]<br/>

==Add Task Attributes==
Task '''attributes''' are useful to describe tasks. Attributes marked with '''M''' are '''mandatory''', because they are
used by the wiki to organize tasks.
'''Attributes''' can be added after a task is created. Click on a attribute row to enable editing.
The following sub sections explain all task attributes in more detail. Different [[#Attributes States| attribute states]] are explained in the last section. <br/><br/>
[[File:Docu_Create_AddAttributes.png|450px]]

===Task Types===
Task types are used by the system to estimate '''[[#Progress|progress]]''' of tasks in different ways. The framework provides three
different task types that imply a hierarchical order. We use a different shade of green in the task state icon for every task type.

'''Different task types:'''
<table style="font-size:smaller;">
<tr>
<td><span style="color:#b7db7b; font-size:17px;">�</span><b>High</b></td>
<td>
High abstraction level → High uncertainty in the estimation of task completion.<br/>
<span style="font-style:italic;">Tasks at a high level for a project may have uncertain duration and end date.</span>
</td>
</tr>
<tr>
<td><span style="color:#76b531; font-size:17px;">�</span><b>Medium</b></td>
<td>
Medium abstraction level → Medium uncertainty in the estimation of task completion.<br/>
<span style="font-style:italic;">Tasks representing an activity within a project may be split into several subtasks.</span>
</td>
</tr>
<tr>
<td><span style="color:#448200; font-size:17px;">�</span><b>Low</b></td>
<td>
Low abstraction level → Low uncertainty in the estimation of task completion.<br/>
<span style="font-style:italic;">Small, well-defined tasks that can be accomplished in a short time period.</span>
</td>
</tr>
</table>
<br/>
'''Task hierarchy examples:'''<br/>
[[File:Docu_Create_AddAttribute_Type_HierachySample.png|550px]]<br/><br/>
'''Rules for assigning a task type:'''<br/>
<b>
<span style="font-size:smaller;">
<span style="color:#b7db7b; font-size:17px;">�</span>High ≤
<span style="color:#76b531; font-size:17px;">�</span>Medium ≤
<span style="color:#448200; font-size:17px;">�</span>Low
</span>
</b><br/><br/>
[[File:Docu_Create_AddAttribute_Type_SelectType.png|400px]]<br/><br/>

===Progress===
The progress of a task indicates how much work has been done as a percentage. The system automatically estimates
progress depending on the '''[[#Task Type|task type]]'''.
The level of progress of high-level tasks is estimated based on the start date, today's date and
the target date. For medium-level tasks, the progress is estimated by aggregating the progress of their subtasks as an average. The progress of low-level
task is always set by the user. <br/><br/>
[[File:Docu_Create_AddAttribute_ProgressCalculation.png|350px]]<br/><br/>
'''Hint:''' Medium-level tasks will hardly ever get done unless you decompose them into clear smaller low-level subtasks.<br/>

===Time Interval===
This section summarizes the meta data attributes '''start date''' and '''target date'''. The time intervals for a task and its subtasks
follow a strictly hierarchical approach. Therefore, the start and target dates of any task must be within the time interval of
the parent task. This leads to a time funnel illustrated on the figure below. If any inconsistency occurs
it will be highlighted in yellow in the Task Status and the Timeline View.<br/><br/>
[[File:Docu_Create_AddAttribute_TimeFunnel.png|300px]]

===Owner===
A task '''owner''' is responsible for coordinating the activities for a task and overseeing its completion.
Therefore the system expects exactly one owner. All task which are assigned to you as owner are shown in your My Task
tab and on your [[Person Page|person page]]. Persons who have a wiki account are shown in blue and linked to their wiki page.
Persons who do not have an account are shown in red. See [[#Participant|participant]] example. <br/><br/>
[[File:Docu_Create_AddAttribute_Owner.png|100px]]

===Participant===
Every task can have many participants. These persons may represent a team or just a working group for the task. Participants
who have a wiki account are shown in blue and linked to their [[Person Page|person page]].
Persons who do not have an account are shown in red. <br/><br/>
[[File:Docu_Create_AddAttribute_Participants.png|200px]]

===Expertise===
Expertise keywords are used to indicate the knowledge you might need to accomplish a task. Several expertise keywords can be assigned to a given task. You can easily recognize
expertise keywords in any page by the grey rectangle around them. The [[Exploring Tasks#Task Explorer|task explorer]] allows to search for tasks with certain expertise keywords.<br/><br/>
[[File:Docu_Create_AddAttribute_Expertise.png|140px]]

===Attributes States===
The task attribute state is represented with different colors for the attribute icons.
<table style="font-size:smaller;">
<tr>
<td><span style="color:#cccccc; font-size:17px;">�</span><b>Not defined</b></td>
<td>
No value for this attribute set.<br/>
<span style="font-style:italic;">You can set this attribute value.</span>
</td>
</tr>
<tr>
<td><span style="color:#b7db7a; font-size:17px;">�</span><b>Valid</b></td>
<td>
A valid value for this attribute is set.<br/>
<span style="font-style:italic;">You can modify the value.</span>
</td>
</tr>
<tr>
<td><span style="color:#fed800; font-size:17px;">�</span><b>Inconsistent</b></td>
<td>
A value that is inconsistent with the parent task is set.<br/>
<span style="font-style:italic;">You can change this value or value of the parent task. Hover over icon to get more instructions.</span>
</td>
</tr>
</table>

==Add Additional Attributes==
Adding additional custom attributes allow to structure any page content with '''key value''' pairs. These additional attributes help to make page content searchable by
custom properties. You can add a new property by clicking on the add button. Click on the cross to remove a certain property.<br/><br/>
[[File:Docu_Create_AddProperty.png|550px]]<br/>
'''Hint:''' You can add more attributes with the same name and a different value. E.g. this content could be led by two persons.<br/>

==Add Content==
After you have added some attributes, you can start adding content to the task page. Click on '''edit''' in the top navigation.
The page editor opens and shows the current page content. Note that even empty pages may already have content generated by the system. This is shown on the example below.
'''<span style="color:red;">It is important that all system-generated content remains untouched</span>'''. You can add your content between the '''<code>[ [Category:Task] ]</code>''' line and before
'''<code>{{#set ... }}</code>'''.<br/><br/>
[[File:Docu_Create_EditContent.png|550px]]
 </td> <td class="menu"><div class="item " style="padding-left:5px; font-size:14px; font-weight:bold;">Organic Data Science Framework Documentation</div><div class="item " style="padding-left:25px; font-size:12px; font-weight:bold;">Contribute as Participant</div><div class="item " style="padding-left:45px; font-size:10px;">Exploring Tasks</div><div class="item " style="padding-left:45px; font-size:10px;">Participating on Tasks</div><div class="item " style="padding-left:45px; font-size:10px;">Person Page</div><div class="item " style="padding-left:45px; font-size:10px;">Basic Task States</div><div class="item " style="padding-left:25px; font-size:12px; font-weight:bold;">Contribute as Owner</div><div class="item selected" style="padding-left:45px; font-size:10px;">Create Task</div><div class="item " style="padding-left:45px; font-size:10px;">Task Alert</div><div class="item " style="padding-left:45px; font-size:10px;">Organize Tasks</div><div class="item " style="padding-left:45px; font-size:10px;">Extended Task States</div></td> </tr></table>

Create Task - Revision history

Admin: Creating new page with Category: Docu