move the rest of the docs over

book/src/xdebug.md

@@ -1 +1,31 @@
 # Xdebug
+
+To use Xdebug running in a haze instance with your IDE for debugging, you need
+to tell you IDE how to properly map the path from the container to the host. The
+IDE debugger config usually looks like:
+
+```json
+	{
+		"label": "PHP: Debug server within docker",
+		"adapter": "Xdebug",
+		"request": "launch",
+		"port": 9003,
+		"pathMappings": {
+			"/var/www/html": "<sources_root_configured_in_haze.toml>",
+			"/var/www/html/apps-extra": "<app_directories_configured_in_haze.toml>",
+		},
+	},
+```
+
+This would have to be adapted for detached instances.
+
+### Debugging all requests
+
+By default, xdebug is configured to only run for requests that containing the
+trigger (e.g. from using the xdebug browser extension, or adding
+`?XDEBUG_SESSION_START=1` to the url).
+
+To enable Xdebug for all requests:
+
+- Uncomment the lines in `haze [cloud-id] edit /config/php.ini`
+- Then run `haze reload [cloud-id]`