diff --git a/rel_qkd/key_rates_qber.jl b/rel_qkd/key_rates_qber.jl
index 5a23ff3a854812a59c8ca0cd48377767f4c1a518..8dc94c2612357c8574262a9010710d25634574e6 100755
--- a/rel_qkd/key_rates_qber.jl
+++ b/rel_qkd/key_rates_qber.jl
@@ -317,11 +317,21 @@ function HAgB(alpha, q; eta)
 end
 
 
+"""
+    key_rate(α, q; eta)
+
+The key rate for a given alpha, qber `q` and transmittance `eta`.
+"""
 function key_rate(α, q; eta)
     return compute_entropy(α, q; eta) - HAgB(α, q; eta)
 end
 
 
+"""
+    key_rate(q; eta)
+
+The key rate for a given qber `q` and transmittance `eta`, optimized over alpha.
+"""
 function key_rate(q; eta)
     res = Optim.optimize(alpha -> -key_rate(alpha, q; eta), 0.0, 0.8)
     @show res