From df7101a32651724c9c6505d3028b7275585adf82 Mon Sep 17 00:00:00 2001
From: mpadge <mark.padgham@email.com>
Date: Tue, 19 Mar 2024 17:06:14 +0100
Subject: [PATCH] add urgency table and explanation for #7

---
 DESCRIPTION        |  2 +-
 codemeta.json      |  2 +-
 quarto/reviews.qmd | 38 ++++++++++++++++++++++++++++++++++++++
 3 files changed, 40 insertions(+), 2 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index dc118a6..dd9b6e6 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,6 +1,6 @@
 Package: dashboard
 Title: What the Package Does (One Line, Title Case)
-Version: 0.0.6.002
+Version: 0.0.6.003
 Authors@R: 
   person(given = "First",
          family = "Last",
diff --git a/codemeta.json b/codemeta.json
index 757cff5..01d3292 100644
--- a/codemeta.json
+++ b/codemeta.json
@@ -6,7 +6,7 @@
   "name": "dashboard: What the Package Does (One Line, Title Case)",
   "codeRepository": "https://github.com/ropensci-review-tools/dashboard",
   "license": "https://spdx.org/licenses/MIT",
-  "version": "0.0.6.002",
+  "version": "0.0.6.003",
   "programmingLanguage": {
     "@type": "ComputerLanguage",
     "name": "R",
diff --git a/quarto/reviews.qmd b/quarto/reviews.qmd
index a930bb7..23d927f 100644
--- a/quarto/reviews.qmd
+++ b/quarto/reviews.qmd
@@ -62,6 +62,44 @@ There are currently:<br>
 - `r sub_types [["Standard"]]` standard issues<br>
 - `r sub_types [["Stats"]]` stats issues
 
+Some cells in the following tables are highlighted to visually indicate the
+following degrees of urgency. Levels of urgency depend on the review stage.
+Approximate expected times required to complete each stage are:
+
+stage | time (days)
+--- | ---
+0\/Pre-submission | 7
+1\/Editor Checks | 7
+2\/Seeking Reviewers | 14
+3\/Reviewer(s) Assigned | 21
+4\/Review(s) in Awaiting Changes | 21
+5\/Awaiting Reviewer(s) Response | 21
+
+Levels of urgency for each review are times taken for current stage as
+a multiple of those base times, with values rounded *down* to nearest integer.
+For example, a submission which has been undergoing `1\/Editor Checks` for 17
+days would have an urgency of `floor(17/7) = 2`. A submission which has been
+under review (stage `3\/Reviewer(s) Assigned`) for 12 weeks would have an
+urgency of `floor(12 * 7 / 21) = 4`. The colour codes for these urgency levels
+are shown in the following table.
+
+```{r colour-scheme, echo = FALSE}
+cols <- dashboard:::define_urgency_colours ()
+udat <- data.frame (
+    urgency = seq_along (cols),
+    importance = c (
+        "low",
+        "moderate",
+        "medium",
+        "high",
+        "very high"
+    )
+)
+gt::gt (udat) |>
+    dashboard:::add_urgency_cols (c ("urgency", "importance"))
+```
+
+
 ## 0\/Pre-submission
 
 ```{r dat0, echo = FALSE}