theory

README.md

@@ -231,11 +231,11 @@ against four limits:
 - In the updated state with per-server stats available, the
   per-server queue depth must be less than the calculated critical
   per-server queue depth $D_{{\rm crit}_j}$, as discussed
-  in the [theory section.]
+  in the [theoretical] section.
 - In the updated state, the total queue depth must be less than
   the saturation queue depth, $D_{\rm sat}$, at which the
   current download bit rate $B_{\rm cur}$ saturates, as calculated
-  in the [theory] section.
+  in the [theoretical] section.
 
 If any of the limits are exceeded, a stochastic wait period
 at the inverse of the current per-server rate $k_j$ is added
@@ -306,7 +306,7 @@ _Flardl_ was written by Joel Berendzen.
 [pypi]: https://pypi.org/
 [file an issue]: https://github.com/hydrationdynamics/flardl/issues
 [pip]: https://pip.pypa.io/
-[theory]: https://github.com/hydrationdynamics/flardl/blob/main/THEORY.md
+[theoretical]: https://github.com/hydrationdynamics/flardl/blob/main/THEORY.md
 
 <!-- github-only -->
 

THEORY.md

@@ -41,13 +41,14 @@ expression are also difficult and overkill, when all we wish
 is a crude estimate of the sweet spot in queue depth. A simple
 heuristic can be found in the analogy of chemical kinetics where
 distributed rates are common. In that situation, a well-known
-trick is to use the depth where the double-exponential derivative
-of bit-rate versus queue depth is maximized:
+trick is to take the saturation depth as where the double-exponential
+derivative of bit-rate $B$ versus average queue depth $\overline{D}$
+is maximized:
 
 $`
 \begin{equation}
-    D_{\rm crit} = c \overbar{D} \backepsilon
-    \max{\frac{d(\log{B}}{d(\log{\overbar{D}})}}
+    D_{\rm sat} = c \overline{D} \backepsilon
+    \max{\frac{d(\log{B})}{d(\log{\overline{D}})}}
 \end{equation}
 `$
 

docs/index.md

@@ -16,6 +16,7 @@ hidden:
 maxdepth: 1
 ---
 
+theory <theory>
 reference
 contributing
 Funding <funding>

docs/theory.md

@@ -3,5 +3,3 @@
 end-before: <!-- github-only -->
 ---
 ```
-
-[theory]: theory