docs: Update query API doc with details about overridding the def decision path #10228

Job	Run time
Rego PR checks	1m 23s
YAML Lint	18s
Generate Code	1m 12s
Go Lint	1m 34s
Go Build (linux amd64)	2m 24s
Check Generated	23s
Go Build (linux arm64)	2m 4s
Go Test (linux)	4m 25s
Go compat build/test (ubuntu-22.04, 1.20)	4m 12s
Go Build (linux arm64GO_TAGS="-tags=opa_no_oci")	2m 9s
Go Test (darwin)	4m 49s
Go Race Detector	5m 58s
Go Build (windows amd64)	2m 25s
Go Build (darwin amd64)	1m 14s
Go compat build/test (macos-14, 1.20)	4m 50s
WASM	14s
Go Build (darwin arm64)	47s
docker image smoke test	39s
smoke-test-binaries (linux, ubuntu-22.04, opa_linux_amd64, amd64)	10s
smoke-test-binaries (linux, ubuntu-22.04, opa_linux_amd64_static, amd64, disabled)	11s
smoke-test-binaries (darwin, macos-13, opa_darwin_amd64, amd64)	26s
smoke-test-binaries (darwin, macos-14, opa_darwin_arm64_static, arm64, disabled)	22s
smoke-test-binaries (windows, windows-latest, opa_windows_amd64.exe, amd64)	29s
	42m 38s

Provide feedback