Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Page properties
Target releasePhase 1
Epic
Document status
Status
colourYellow
titleDRAFTin dev
Document owner

Rory Davidson

AnalystEmily Wang
Designer
Developers
QA

...

  • A task represents a work task
  • A task is represented as a JIRA ticket within a specific project
  • This task is also represented as a task branch on the terminology server
  • A task can be linked to one or many SIRS (or equivalent) requests

Requirements - done and implemented

#TitleRequirement DescriptionUser StorySprintNotesJIRA Tickets 
1Creation of a task

It must allow to

  • create a task by project lead
  • assign the task to an author
  • define task title, project name, and description of the task
  • notify the author whom has been assigned the ticket
As an author lead, I want to create a work task and assign to an author so that author can receive a task from author lead directly.4

A JIRA ticket would be created on the specific project to represent the task

 

  • Create a task by project lead in Jira
 
2Creation of a task

It must enable to

  • create a task by author
  • define task title, project name, and description of the task
  • save the task (into TS and Jira).
As an author, I want to create my own task to deal with some content I have been asked to edit or create so that I can provide summary of my task.1A JIRA ticket would be created on the specific project to represent the task

Jira
serverjira.ihtsdotools.org JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdb202d822-d767-33be-b234-fec5accd5d8c
keyWRP-495

Jira
serverjira.ihtsdotools.org JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdb202d822-d767-33be-b234-fec5accd5d8c
keyWRP-496

Jira
serverjira.ihtsdotools.org JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdb202d822-d767-33be-b234-fec5accd5d8c
keyWRP-497

 
3Adding content to a task

It should require author to provide free text. For example

  • request IDs, summary of each request, and manager of that request in the description of the task.

Note: this requirement is only for minimum viable product but not the final delivery.

As an author, I want to work within a task and have the work I have done tracked for future reference2All editing during the context of the task should be audited and retrievable against the task
  • Require author to provide information

 

 
4Adding content to a task from a file

It should allow author to upload a list of request IDs as a file into task.

Note: this requirement is only for minimum viable product in phase 1.

As an author, I want to import a list of request IDs as a file to create the worklist within the task3 
  • A button to load file into task
  • Able to open the uploaded file from task
 
5Changing status of a task

It must be able to

  • change status from 'New' to 'In progress' when author start working on a task in SCATSCA
  • change status from 'In progress' to 'Peer ReviewIn review' when author is ready to submit for reviewChange
  • change status from 'Peer ReviewIn review' back to "In Progress" when a reviewer needs further work to be donechange status from 'Peer Review completed' to 'Ready for promotion' when review is completed and all contents are approved
  • change status from 'Ready for promotionReview completed' to 'Promoted' when author promoted a task to project level.
  • change status from 'Promoted' to 'Completed' when a task is promoted to project and has no conflict with other tasks in the projectmerged to the mainline
As an author, I want to change status of task so that I can move forward my task to the next state. 2 
  • Update the status of the task from 'New' to 'In progress' when author open the task in the SCAT.
  • Update the status of task to "Peer Review" after click the button 'Ready for review'
  • Allow author to assign the task to a reviewer after click the button 'Ready for review'
  • Update the status of task to "Ready for promotion" after reviewer approved the task
  • Allow reviewer to assign the task back to the author when the task is 'Ready for promotion'
  • Update the status of task to "promoted" when a task has been promoted to project.
  • Update the status of task to "completed" after project is promoted to project and the task has no conflict with other task in the project
   
6Notifying user when a task is assigned to him/her by other user

 It must

  • notify a reviewer when a task is ready for review and assign to them
  • notify an author when his/her task is 'ready for promotion'
  • notify project lead when a task is promoted to project

As an author, I want to be notified when a task is assigned to me 3 
  • notify the reviewer when a task is assigned to him/her for reviewnotify the author when his/her task is 'ready for promotion'
  • notify the project lead when a task is in status 'Promoted' in his/her project
  • notify the author when his/her task is 'completed'

 
7Notifying user when any request in task has been modified It must notify user when any requests in task has been modified in request management toolAs an author, I want to be notified immediately when a request in my task has been modified so that I can have the latest information for authoring.   
8Searching a task on dashboard It must be able to search a task on dashboard by any column or text search

As an author, I want to search task by

  • title of task
  • assigned to me
  • reported by me
  • project name
  • status of task
  • text search (specify the fields in tasks that I want to search for)
2 
  • search in a text search box
  • ascending/descending alphabet search of each column
 

Workflow of task

...

 

Authoring task workflow

...

Workflow in P

Gliffy Diagram
nameTask Workflow in Phase 1

...

In progress: when an author starts working on a new task, it will enter this state.  When classification is failed because of classification errors, it will come back to this state from 'Classification'. When classification is completed with no errors but author modifies any concepts have been classification, it will come back to this state from 'Classification' and author has to classify the task again. When reviewing is completed by an reviewer but it has errors in the task, it will come back to this state from 'Peer review'.

Classification: when an author clicks the 'Classify' button, it will enter this state.

It includes editing, classification, validation, and rebasing (to discover conflicts between tasks in the same project).

In Peer review: when an author clicks the 'Ready for review' button, it will enter this state. The authors with reviewing role will see this task in the 'Review Tasks' list on the dashboard.

Escalation: when editing author and reviewing author have different opinions in a task, it will enter this state. Authoring team will discuss the issues in this task and provide a final decision.

Ready for promotion: when Review completed: after a task is reviewed by reviewer and there is no need to make any changes in this task the task status has been manually changed from "Review in progress" to "Review complete in Review view, it will enter this state. 

Promoted to projectwhen a task is rebased with no conflicts and promoted to the project level in TS, it will enter this state.

Completed: when the task promoted to the project level has with no conflict conflicts and author is ready merged to close the taskmainline, it will enter this state.Pending answer: when an author has to clarify a request or put a request on hold, it will enter this state. After a certain time (need to be defined by authoring team), if author cannot get response from requestor, then author will remove that request from the task. The status of the task will be changed to 'In progress' then.

 

Questions

Below is a list of questions to be addressed as a result of this requirements document:

...