Clarify and interlink EST_INTRO_DOS_EXT extension

1 files changed, 18 insertions, 5 deletions

diff --git a/spec/param-spec.md b/spec/param-spec.md
index 088ee77..ee96dfd 100644
--- a/spec/param-spec.md
+++ b/spec/param-spec.md
@@ -305,22 +305,35 @@ introduction.
 Min 1. Max 10. Default 2.
 First-appeared: 0.3.3.0-alpha.
 
-"HiddenServiceEnableIntroDoSDefense" -- This parameter makes tor
-start using this defense if the introduction point supports it
-(for protover HSIntro=5).
+<a id="HiddenServiceEnableIntroDoSDefense"></a>
+"HiddenServiceEnableIntroDoSDefense" -- This parameter makes
+introduction points
+start using a rate-limiting defense if they support it.
+Introduction points use this value when no
+[denial-of-service parameters extension] is sent.
 Min: 0. Max: 1. Default: 0.
 First appeared: 0.4.2.1-alpha.
 
-"HiddenServiceEnableIntroDoSBurstPerSec" -- Maximum burst to be used
+<a id="HiddenServiceEnableIntroDoSBurstPerSec"></a>
+"HiddenServiceEnableIntroDoSBurstPerSec" -- Default maximum burst
+rate to be used
 for token bucket for the introduction point rate-limiting.
+Introduction points use this value when no
+[denial-of-service parameters extension] is sent.
 Min: 0. Max: INT32_MAX. Default: 200
 First appeared: 0.4.2.1-alpha.
 
-"HiddenServiceEnableIntroDoSRatePerSec" -- Refill rate to be used
+<a id="HiddenServiceEnableIntroDoSRatePerSec"></a>
+"HiddenServiceEnableIntroDoSRatePerSec" -- Default maximum rate per second
+to be used
 for token bucket for the introduction point rate-limiting.
+Introduction points use this value when no
+[denial-of-service parameters extension] is sent.
 Min: 0. Max: INT32_MAX. Default: 25
 First appeared: 0.4.2.1-alpha.
 
+[denial-of-service parameters extension]: ./rend-spec/introduction-protocol.md#EST_INTRO_DOS_EXT
+
 <a id="param-spec.txt-9"></a>
 
 ## Denial-of-service parameters {#dos}