docs: added debug notes
@@ -146,6 +146,38 @@ dlv --listen=:2345 --headless=true --api-version=2 exec ./bin/lighthouse -- $*
You can then debug from your Go-based IDE (e.g. GoLand / IDEA / VS Code).
+### Debugging webhooks
+
+If you want to debug lighthouse locally from webhooks in your cluster there are a couple of tools that could help:
+
+#### Localizer
+
+If you [install localizer](https://github.com/jaredallard/localizer#install-localizer) (see [the blog for more detail](https://blog.jaredallard.me/localizer-an-adventure-in-creating-a-reverse-tunnel-and-tunnel-manager-for-kubernetes/) you can easily debug webhooks on your cluster.
+
+* first run localizer:
+
+```bash
+sudo localizer
+```
+
+Then run/debug lighthouse locally.
+
+e.g. in your IDE run the [cmd/webhooks/main.go](https://github.com/jenkins-x/lighthouse/blob/master/cmd/webhooks/main.go) (passing `--namespace jx` as program arguments)
+
+Then to get the webhooks to trigger your local process:
+
+```bash
+localizer expose jx/hook --map 80:8080
+```
+
+when you have finished debugging, return things to normal via:
+
+```bash
+localizer expose jx/hook --stop
+```
+
+
+#### Telepresence
You can replace the running version in your cluster with the one running locally using [telepresence](https://www.telepresence.io/).
For webhooks, just run:
```bash
