From b09c6870fe6c5e246a9833a75801053380464602 Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sun, 8 Jun 2025 21:31:47 -0300 Subject: [PATCH] docs: add note about watcher reliability --- website/docs/usage.mdx | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/website/docs/usage.mdx b/website/docs/usage.mdx index 6fdc1eb1..9590cf4f 100644 --- a/website/docs/usage.mdx +++ b/website/docs/usage.mdx @@ -2381,6 +2381,21 @@ if called by another task, either directly or as a dependency. ::: +:::caution + +The watcher can misbehave in certain scenarios, in particular for long-running +servers. +There is a known bug where child processes of the running might not be killed +appropriately. It's adviced to avoid running commands as `go run` and prefer +`go build [...] && ./binary` instead. + +If you are having issues, you might want to try tools specifically designed for +live-reloading, like [Air](https://github.com/air-verse/air/). Also, be sure to +[report any issues](https://github.com/go-task/task/issues/new?template=bug_report.yml) +to us. + +::: + {/* prettier-ignore-start */} [gotemplate]: https://golang.org/pkg/text/template/ [templating-reference]: ./reference/templating.mdx