Merge proposal 336-randomize-guard-retries.md

1 files changed, 20 insertions, 0 deletions

diff --git a/guard-spec.txt b/guard-spec.txt
index 357583b..9a15eb8 100644
--- a/guard-spec.txt
+++ b/guard-spec.txt
@@ -719,12 +719,32 @@ A.1.  Parameters with suggested values. [Section:PARAM_VALS]
    {param:N_PRIMARY_GUARDS} -- 3
 
    {param:PRIMARY_GUARDS_RETRY_SCHED}
+
+      We recommend the following schedule, which is the one
+      used in Arti:
+
+      -- Use the "decorrelated-jitter" algorithm from "dir-spec.txt"
+         section 5.5 where `base_delay` is 30 seconds and `cap`
+         is 6 hours.
+
+      This legacy schedule is the one used in C tor:
+
       -- every 10 minutes for the first six hours,
       -- every 90 minutes for the next 90 hours,
       -- every 4 hours for the next 3 days,
       -- every 9 hours thereafter.
 
    {param:GUARDS_RETRY_SCHED} --
+
+      We recommend the following schedule, which is the one
+      used in Arti:
+
+      -- Use the "decorrelated-jitter" algorithm from "dir-spec.txt"
+         section 5.5 where `base_delay` is 10 minutes and `cap`
+         is 36 hours.
+
+      This legacy schedule is the one used in C tor:
+
       -- every hour for the first six hours,
       -- every 4 hours for the 90 hours,
       -- every 18 hours for the next 3 days,