From 6244d77a12f2e69afaa7d0e480ef750d84eecdb2 Mon Sep 17 00:00:00 2001
From: David Perl <david.perl@psi.ch>
Date: Tue, 4 Aug 2026 15:41:29 +0200
Subject: [PATCH] docs: udpate cheatsheet formatting

---
 docs/cheatsheet.md | 94 +++++++++++++++++++++++++---------------------
 1 file changed, 52 insertions(+), 42 deletions(-)

diff --git a/docs/cheatsheet.md b/docs/cheatsheet.md
index a4a57f37..924d645e 100644
--- a/docs/cheatsheet.md
+++ b/docs/cheatsheet.md
@@ -1,53 +1,63 @@
 # GUI Controls Cheat Sheet
 
-### Sample Camera
+## Sample Camera
 
-- `Left click`: move sample to clicked position
-- `Shift + Left click`: Z-alignment click behaviour
-- `Ctrl + Left click` on active raster grid: move to clicked position under the grid
-- `Left drag` on active raster grid: move active raster grid
-- `Right click`: open sample camera context menu
-- `Right drag` on empty area: draw raster grid
-- `Right drag` on active raster grid: resize raster grid
-- `Mouse wheel`: rotate omega by 90°
-- `Shift + Mouse wheel`: rotate omega by 10°
-- `Ctrl + Mouse wheel`: change sample camera exposure by a large step
-- `Alt + Mouse wheel`: change sample camera exposure by a small step
-- `Shift + Mouse move`: inspect/load raster image under cursor
+| Control               | Applies to         | Action                                        |
+| --------------------- | ------------------ | --------------------------------------------- |
+| `Left click`          |                    | move sample to clicked position               |
+| `Shift + Left click`  |                    | Z-alignment click behaviour                   |
+| `Ctrl + Left click`   | active raster grid | move to clicked position under the grid       |
+| `Left drag`           | active raster grid | move active raster grid                       |
+| `Right click`         |                    | open sample camera context menu               |
+| `Right drag`          | empty area         | draw raster grid                              |
+| `Right drag`          | active raster grid | resize raster grid                            |
+| `Mouse wheel`         |                    | rotate omega by 90°                           |
+| `Shift + Mouse wheel` |                    | rotate omega by 10°                           |
+| `Ctrl + Mouse wheel`  |                    | change sample camera exposure by a large step |
+| `Alt + Mouse wheel`   |                    | change sample camera exposure by a small step |
+| `Shift + Mouse move`  |                    | inspect/load raster image under cursor        |
 
-### Video Views
+## Video Views
 
-- `Ctrl + Mouse wheel`: zoom in/out
-- `F`: fit to view
-- `R`: reset zoom
-- `+` or `=`: zoom in
-- `-`: zoom out
+| Control              | Action      |
+| -------------------- | ----------- |
+| `Ctrl + Mouse wheel` | zoom in/out |
+| `F`                  | fit to view |
+| `R`                  | reset zoom  |
+| `+` or `=`           | zoom in     |
+| `-`                  | zoom out    |
 
-### Sample Queue
+## Sample Queue
 
-- `Delete`: remove selected samples
-- `Space`: run / pause queue automation
+| Control  | Action                       |
+| -------- | ---------------------------- |
+| `Delete` | remove selected samples      |
+| `Space`  | run / pause queue automation |
 
-### Workflow Panel
+## Workflow Panel
 
-- `Delete`: remove selected queue items
-- `Space`: pause / resume workflow
-- `Ctrl + R`: refresh workflow queue
-- `Ctrl + Delete`: clear non-running workflow queue items
+| Control         | Action                                 |
+| --------------- | -------------------------------------- |
+| `Delete`        | remove selected queue items            |
+| `Space`         | pause / resume workflow                |
+| `Ctrl + R`      | refresh workflow queue                 |
+| `Ctrl + Delete` | clear non-running workflow queue items |
 
-### Global Shortcuts
+## Global Shortcuts
 
-- `F1`: open mouse / keyboard controls help
-- `Ctrl + Q`: quit application
-- `Ctrl + Shift + R`: restore default view layout
-- `Ctrl + 1`: switch to Sample camera tab
-- `Ctrl + 2`: switch to Gonio camera tab
-- `Ctrl + 3`: switch to Beamline view tab
-- `Ctrl + 4`: switch to Beamline combined view tab
-- `Ctrl + L`: raise Sample List panel
-- `Ctrl + J`: raise Automation list panel
-- `Ctrl + M`: go to Sample camera tab
-- `Ctrl + W`: toggle Workflow panel
-- `Ctrl + Shift + T`: toggle Target stability panel
-- `Ctrl + Shift + P`: toggle Prediction Metrics panel
-- `Ctrl + Shift + S`: toggle Smargon trace panel
+| Control            | Action                               |
+| ------------------ | ------------------------------------ |
+| `F1`               | open mouse / keyboard controls help  |
+| `Ctrl + Q`         | quit application                     |
+| `Ctrl + Shift + R` | restore default view layout          |
+| `Ctrl + 1`         | switch to Sample camera tab          |
+| `Ctrl + 2`         | switch to Gonio camera tab           |
+| `Ctrl + 3`         | switch to Beamline view tab          |
+| `Ctrl + 4`         | switch to Beamline combined view tab |
+| `Ctrl + L`         | raise Sample List panel              |
+| `Ctrl + J`         | raise Automation list panel          |
+| `Ctrl + M`         | raise manual sample dock             |
+| `Ctrl + W`         | toggle Workflow panel                |
+| `Ctrl + Shift + T` | toggle Target stability panel        |
+| `Ctrl + Shift + P` | toggle Prediction Metrics panel      |
+| `Ctrl + Shift + S` | toggle Smargon trace panel           |