RefractTrack Tasks: Difference between revisions

Revision as of 13:46, 28 August 2026

Tasks

A task is the basic unit of work in RefractTrack — a single feature, fix, art request, or to-do, always living inside one Project and identified by a short code like RPG-12.

What's on a task

Title and Description — the description supports light text formatting, so you can bold, italicize, list, and add code snippets.
Type — either a regular task or a Bug.
Priority — Low, Medium, High, or Critical.
Stage — which column the task currently sits in on the board. See Stages.
Assignee — who's working on it. Optional, unless the column it's in requires one.
Due date — optional.
Groups — any number of color-coded tags. See Groups.
Review status — whether it's still pending sign-off, approved, or marked "won't do." See Approvals and Review.
Archived — whether it's been tucked away off the active board. See Archiving.

Bug reports get extra fields

Switch a task's Type to Bug and three extra fields appear: Expected behavior, Actual behavior, and Steps to reproduce. They show up on the task detail page in their own dedicated panel, and they're also available as fill-in-the-blank templates when creating a batch of bug reports at once (see Bulk Task Creation).

Task codes link themselves

Mention a task code like FE-12 anywhere formatted text appears — a description, a comment, another task — and RefractTrack automatically turns it into a clickable link to that task, as long as it's a real task and you're allowed to see it. No extra steps needed.

Creating tasks

There are a few ways to add a task, depending on who's adding it and how much detail they need to provide:

The full task form — the everyday way to create a task, with every field available.
The reporter form — a stripped-down "submit a ticket" form for teammates (like playtesters or QA) who should be able to flag something without full access to the board. Tickets submitted this way land automatically in the project's first column, unassigned, at Medium priority.
Bulk create — for generating a whole batch of similar tasks at once. See Bulk Task Creation.
Clone — duplicate any existing task as a starting point for a new one.

Editing and moving tasks

You can move a task between columns from its detail page, from the edit form, or simply by dragging it across the board — see Board and List Views. If the column you're moving it into is one that requires an assignee (In Progress and In Review, by default), you'll be asked to pick one first.

Deleting tasks

Deleting a task removes it for good — a quiet backup record is kept behind the scenes for audit purposes even after it's gone from the board, but there's no everyday "undo." If you just want to clear finished or abandoned work off the board without losing it, Archiving is almost always the better choice.

@@ Line 1: / Line 1: @@
 == Tasks ==
-A task is the core unit of work in RefractTrack, always scoped to a single [[RefractTrack_Projects|Project]] and identified by a task code like <code><nowiki>RPG-12</nowiki></code> (its project's prefix plus a sequential number).
+A task is the basic unit of work in RefractTrack — a single feature, fix, art request, or to-do, always living inside one [[RefractTrack_Projects|Project]] and identified by a short code like ''RPG-12''.
-=== Fields ===
+=== What's on a task ===
-Every task has:
+* '''Title''' and '''Description''' — the description supports light [[RefractTrack_Markdown_Formatting|text formatting]], so you can bold, italicize, list, and add code snippets.
+* '''Type''' — either a regular task or a Bug.
+* '''Priority''' — Low, Medium, High, or Critical.
+* '''Stage''' — which column the task currently sits in on the board. See [[RefractTrack_Stages|Stages]].
+* '''Assignee''' — who's working on it. Optional, unless the column it's in requires one.
+* '''Due date''' — optional.
+* '''Groups''' — any number of color-coded tags. See [[RefractTrack_Groups|Groups]].
+* '''Review status''' — whether it's still pending sign-off, approved, or marked "won't do." See [[RefractTrack_Approvals_and_Review|Approvals and Review]].
+* '''Archived''' — whether it's been tucked away off the active board. See [[RefractTrack_Archiving|Archiving]].
-* '''Title''' and '''Description''' (description supports the [[RefractTrack_Markdown_Formatting|Markdown Formatting]] subset)
+=== Bug reports get extra fields ===
-* '''Type''' — <code><nowiki>Normal</nowiki></code> or <code><nowiki>Bug</nowiki></code>
-* '''Priority''' — <code><nowiki>Low</nowiki></code>, <code><nowiki>Medium</nowiki></code>, <code><nowiki>High</nowiki></code>, or <code><nowiki>Critical</nowiki></code> (defaults to <code><nowiki>Medium</nowiki></code>)
-* '''Stage''' — which [[RefractTrack_Stages|Stage]] (swimlane) the task currently sits in
-* '''Assignee''' — optional, but required when moving into a stage flagged <code><nowiki>requires_assignee</nowiki></code>
-* '''Due date''' — optional
-* '''Groups''' — zero or more [[RefractTrack_Groups|Groups]], a many-to-many tag
-* '''Review status''' — <code><nowiki>pending</nowiki></code>, <code><nowiki>approved</nowiki></code>, or <code><nowiki>wont_do</nowiki></code>; see [[RefractTrack_Approvals_and_Review|Approvals and Review]]
-* '''Archived state''' — orthogonal to stage and review status; see [[RefractTrack_Archiving|Archiving]]
-=== Bug-specific fields ===
+Switch a task's Type to Bug and three extra fields appear: '''Expected behavior''', '''Actual behavior''', and '''Steps to reproduce'''. They show up on the task detail page in their own dedicated panel, and they're also available as fill-in-the-blank templates when creating a batch of bug reports at once (see [[RefractTrack_Bulk_Task_Creation_and_Saved_Lists|Bulk Task Creation]]).
-Tasks with '''Type = Bug''' get three extra optional fields, shown and hidden automatically based on the Type radio:
+=== Task codes link themselves ===
-* '''Expected behavior'''
+Mention a task code like ''FE-12'' anywhere formatted text appears — a description, a comment, another task — and RefractTrack automatically turns it into a clickable link to that task, as long as it's a real task and you're allowed to see it. No extra steps needed.
-* '''Actual behavior'''
-* '''Steps to reproduce'''
-These appear on the full task form, the [[RefractTrack_Bulk_Task_Creation_and_Saved_Lists|bulk create]] form (as templates using the same placeholder substitution as title/description), and the simplified reporter submission form. They're cleared server-side whenever a task's type isn't Bug, and are shown in their own "Bug Details" panel on the task detail page when present.
+=== Creating tasks ===
-=== Task codes and auto-linking ===
-Every task has a permanent code (<code><nowiki>PREFIX-123</nowiki></code>). Anywhere free text is rendered through the markdown renderer, text matching the <code><nowiki>PREFIX-123</nowiki></code> pattern is automatically scanned and, if it resolves to a real task, turned into a link to that task — see [[RefractTrack_Markdown_Formatting|Markdown Formatting]]. The link is only generated for users who can actually view tasks (<code><nowiki>tasks:view</nowiki></code>); otherwise the code is left as plain text rather than pointing somewhere the viewer can't reach.
-=== Creating tasks ===
+There are a few ways to add a task, depending on who's adding it and how much detail they need to provide:
-* '''Full task form''' (<code><nowiki>task_form.php</nowiki></code>) — available to users with <code><nowiki>tasks:create</nowiki></code>, exposes every field above.
+* '''The full task form''' — the everyday way to create a task, with every field available.
-* '''Reporter form''' (<code><nowiki>report.php</nowiki></code>) — a simplified "submit a ticket" form for users who only hold <code><nowiki>tasks:report</nowiki></code> (typically playtesters/QA). Tickets filed this way always start in the project's first stage, unassigned, at Medium priority, and reporters can only submit to the specific projects they've been granted access to.
+* '''The reporter form''' — a stripped-down "submit a ticket" form for teammates (like playtesters or QA) who should be able to flag something without full access to the board. Tickets submitted this way land automatically in the project's first column, unassigned, at Medium priority.
-* '''Bulk create''' — see [[RefractTrack_Bulk_Task_Creation_and_Saved_Lists|Bulk Task Creation and Saved Lists]].
+* '''Bulk create''' — for generating a whole batch of similar tasks at once. See [[RefractTrack_Bulk_Task_Creation_and_Saved_Lists|Bulk Task Creation]].
-* '''Clone''' — any existing task can be duplicated via the Clone action, subject to <code><nowiki>tasks:clone</nowiki></code>.
+* '''Clone''' — duplicate any existing task as a starting point for a new one.
 === Editing and moving tasks ===
-* Editing a task's content (title, description, type, priority, groups) requires <code><nowiki>tasks:edit:content</nowiki></code>.
+You can move a task between columns from its detail page, from the edit form, or simply by dragging it across the board — see [[RefractTrack_Board_and_List_Views|Board and List Views]]. If the column you're moving it into is one that requires an assignee (In Progress and In Review, by default), you'll be asked to pick one first.
-* Moving a task between stages — including setting the assignee and due date at the same time — requires <code><nowiki>tasks:edit:stage</nowiki></code>. This can be done from the task detail page, the task edit form, or by dragging the task on the [[RefractTrack_Board_and_List_Views|board]].
-* Moving a task into a stage flagged <code><nowiki>requires_assignee</nowiki></code> (by default: '''In Progress''' and '''In Review''') always requires picking an assignee first, regardless of which of the above three paths is used.
-* A task's stage dropdown always includes the task's ''current'' stage even if that stage has since been hidden from the board — otherwise saving the form would silently drop it back to a different stage.
 === Deleting tasks ===
-Permanent deletion (<code><nowiki>tasks:delete</nowiki></code>) removes a task outright. A standalone snapshot of every hard-deleted task is preserved in a <code><nowiki>deleted_task_log</nowiki></code> table for audit purposes even after the live row is gone. For non-destructive removal from the active board, see [[RefractTrack_Archiving|Archiving]] instead.
+Deleting a task removes it for good — a quiet backup record is kept behind the scenes for audit purposes even after it's gone from the board, but there's no everyday "undo." If you just want to clear finished or abandoned work off the board without losing it, [[RefractTrack_Archiving|Archiving]] is almost always the better choice.
 === Related pages ===
@@ Line 54: / Line 45: @@
 * [[RefractTrack_Stages|Stages]]
 * [[RefractTrack_Groups|Groups]]
-* [[RefractTrack_Comments_and_Activity_Log|Comments and Activity Log]]
+* [[RefractTrack_Comments_and_Activity_Log|Comments and Activity]]
 * [[RefractTrack_Attachments|Attachments]]
-* [[RefractTrack_Markdown_Formatting|Markdown Formatting]]
+* [[RefractTrack_Markdown_Formatting|Formatting Text]]
 * [[RefractTrack_Export_and_Import|Export and Import]]

Nerdofepic (talk | contribs)