From 6112132e097b896543beb378240b78f8acf9c51e Mon Sep 17 00:00:00 2001
From: awage <>
Date: Fri, 26 Apr 2024 09:13:20 +0200
Subject: [PATCH] docs

---
 src/stagger/stagger.jl | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/stagger/stagger.jl b/src/stagger/stagger.jl
index 830b8d24..fbb88306 100644
--- a/src/stagger/stagger.jl
+++ b/src/stagger/stagger.jl
@@ -133,12 +133,16 @@ from a region defined by the user (see the argument
 
 Given the dynamical mapping `F`, if the iteration `x_{n+1} = 
 F(x_n)` respects the condition `T(x_{n+1}) > Tm` we accept 
-this next point. If not, the method search randomly the next 
-point in a neighborhood following a given probability 
-distribution (see the keyword argument `stagger_mode`).   
-
-The method produces a trajectory of `N` points close to the 
-stable manifold of the chaotic saddle. 
+this next point, this is the _step_ part of the method. If 
+not, the method search randomly the next point in a 
+neighborhood following a given probability distribution, this 
+is the _stagger_ part. This part sometimes fails to find a new 
+candidate and a new starting point of the trajectory is chosen 
+within the defined region. See the keyword argument 
+`stagger_mode` for the different available methods.   
+
+The method produces a pseudo-trajectory of `N` points δ-close
+to the stable manifold of the chaotic saddle. 
 
 ## Keyword arguments
 * `δ = 1e-10`: it is a small number constraining the random