docs: add note about watcher reliability

Author: andreynering

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