diff --git a/docs/README.md b/docs/README.md
index d0f8f87..d76488c 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -2,11 +2,51 @@
 
 ![](./banner_long.png)
 
+
+When perfecting 3D prints and tuning your printer, there is all that resonance testing stuff that Shake&Tune will try to help you with. But keep in mind that it's part of a complete process, and Shake&Tune alone won't magically make your printer print at lightning speed. Also, when using the tools, **it's important to get back to the original need: good prints**.
+
+While there are some ideal goals described in this documentation, you need to understand that it's not always possible to achieve the ideal resonance graphs due to a variety of factors unique to each printer, such as precision of the assembly, quality and brand of components, components wear, etc. Even a different accelerometer can give different results. But that's not a problem; the primary goal is to produce clean and satisfactory prints. If your test prints look good and meet your standards, even if the response curves aren't perfect, you're on the right track. **Trust your printer and your print results more than chasing ideal graphs!** If it's satisfactory, there's no need for further adjustments.
+
+
 ## Resonance testing
 
-First, check out the **[input shaping and tuning generalities](./is_tuning_generalities.md)** documentation to understand how it all works and what to look for when taking these measurements.
+First, check out the **[input shaping and tuning generalities](./is_tuning_generalities.md)** documentation to understand how it all works and what to look for when taking these measurements. A standard tuning workflow might look something like this:
 
-Then look at the documentation for each type of graph by clicking on them below tu run the tests and better understand your results to tune your machine!
+```mermaid
+flowchart LR
+    start([Start]) --> tensionBelts[Tension your\nbelts as best\n as possible]
+    checkmotion --> tensionBelts
+    tensionBelts --> SnT_Belts[Run Shake&Tune\nbelts comparison tool]
+    SnT_Belts --> goodbelts{Check the documentation\nDoes belts comparison profiles\nlook decent?}
+    goodbelts --> |YES| SnT_IS[Run Shake&Tune\naxis input shaper tool]
+    goodbelts --> |NO| checkmotion[Fix your mechanical assembly\nand your motion system]
+    SnT_IS --> goodIS{Check the documentation\nDoes axis profiles and\n input shapers look decent?}
+    goodIS --> |YES| SnT_Vibrations[Run Shake&Tune\nvibration profile tool]
+    goodIS--> |NO| checkmotion
+    SnT_Vibrations --> goodvibs{Check the documentation\nAre the graphs OK?\nSet the speeds in\nyour slicer profile}
+    goodvibs --> |YES| pressureAdvance[Tune your\npressure advance]
+    goodvibs --> |NO| checkTMC[Dig into TMC drivers\ntuning if you want to]
+    goodvibs --> |NO| checkmotion
+    checkTMC --> SnT_Vibrations
+    pressureAdvance --> extrusionMultiplier[Tune your\nextrusion multiplier]
+    extrusionMultiplier --> testPrint[Do a test print]
+    testPrint --> printGood{Is the print good?}
+    printGood --> |YES| unicorn{want to chase unicorns}
+    printGood --> |NO -> Underextrusion / Overextrusion| extrusionMultiplier
+    printGood --> |NO -> Corner humps and no ghosting| pressureAdvance
+    printGood --> |NO -> Visible VFAs| SnT_Vibrations
+    printGood --> |NO -> Ghosting, ringing, resonance| SnT_IS
+    unicorn --> |NO| done
+    unicorn --> |YES| SnT_Belts
+
+    classDef default fill:#70088C,stroke:#150140,stroke-width:4px,color:#ffffff;
+    classDef questions fill:#FF8D32,stroke:#F24130,stroke-width:4px,color:#ffffff;
+    classDef startstop fill:#F2055C,stroke:#150140,stroke-width:3px;
+    class start,done startstop;
+    class goodbelts,goodIS,goodvibs,printGood,unicorn questions;
+```
+
+You can access the documentation for each type of graph by clicking on them below.
 
 | [Belt response comparison](./macros/belts_tuning.md) | [Axis input shaper graphs](./macros/axis_tuning.md) | [Vibrations profile](./macros/vibrations_profile.md) |
 |:----------------:|:------------:|:---------------------:|
diff --git a/docs/macros/belts_tuning.md b/docs/macros/belts_tuning.md
index 225ed00..0ce42c0 100644
--- a/docs/macros/belts_tuning.md
+++ b/docs/macros/belts_tuning.md
@@ -1,11 +1,11 @@
 # Belt relative difference measurements
 
-The `COMPARE_BELTS_RESPONSES` macro is dedicated for CoreXY machines where it can help you to diagnose belt path problems by measuring and plotting the differences between their behavior. It will also help you tension your belts at the same tension.
+The `COMPARE_BELTS_RESPONSES` macro is dedicated for CoreXY machines where it can help you to diagnose belt path problems by measuring and plotting the differences between their behavior. It will also help you tension your belts at the same tension. Using it on Cartesian printers doesn't really make sense, as it's normal to have different responses in that case.
 
 
 ## Usage
 
-**Before starting, ensure that the belts are properly tensioned**. For example, you can follow the [Voron belt tensioning documentation](https://docs.vorondesign.com/tuning/secondary_printer_tuning.html#belt-tension). This is crucial: you need a good starting point to then iterate from it!
+**Before starting, ensure that the belts are properly pre-tensioned**. For example, you can follow the [Voron belt tensioning documentation](https://docs.vorondesign.com/tuning/secondary_printer_tuning.html#belt-tension). This is crucial: you need a good starting point to then iterate from it!
 
 Then, call the `COMPARE_BELTS_RESPONSES` macro and look for the graphs in the results folder. Here are the parameters available:
 
@@ -33,6 +33,10 @@ Aside from the actual belt tension, the resonant frequency/amplitude of the curv
 
 **If these three parameters are met, there is no way that the curves could be different** or you can be sure that there is an underlying problem in at least one of the belt paths. Also, if the belt graphs have low amplitude curves (no distinct peaks) and a lot of noise, you will probably also have poor input shaper graphs. So before you continue, ensure that you have good belt graphs or fix your belt paths. Start by checking the belt tension, bearings, gantry screws, alignment of the belts on the idlers, and so on.
 
+  > **Note**:
+  >
+  > If you are using this tool to check or adjust the tension after installing new belts, you will need to measure again after a few hours of printing, as the tension can change slightly as the belts stretch and settle to their final tension. Usually 24 hours should be sufficient.
+
 
 ## Advanced explanation on why 1 or 2 peaks