From 405fe6def91dfc29a875f6a333a89610bb4ab63a Mon Sep 17 00:00:00 2001 From: Rob Savoye Date: Sun, 7 Jan 2024 11:29:01 -0700 Subject: [PATCH] fix: Add content on the tasks utility tables --- docs/tmschema.md | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/docs/tmschema.md b/docs/tmschema.md index 16814b75..7f05798d 100644 --- a/docs/tmschema.md +++ b/docs/tmschema.md @@ -69,12 +69,31 @@ A task is the area for a mapper to map. Task management is obviously a key function of the Tasking Manager. * tasks - Primary table -* task_annotations - Utility table for something, it apperas to be +* task_annotations - Utility table for something, it appears to be unused anywhere * task_history - Table for task history * task_invalidation_history - Table for task invalidation history * task_mapping_issues - Table for issues with a task +### Task History Table + +This table is used to track the state changes for a task, not +including a task being invalidated. It contains a description of the +status change, when it changed, and the user ID when the task is +locked for mapping. A single task for a project may go through several +state changes during it's lifespan. + +### Task Invalidation History Table + +This table is used to track tasks that are invalidated. Unlike simple +state changes in the task history table, this tracks which validator +invalidated the task, when it was invalidated, and when the issue is +resolved. + +### Task Mapping Issues + +TBD + ## Team Tables This is for OSM Team support.