diff --git a/website/source/docs/commands/validate.html.md.erb b/website/source/docs/commands/validate.html.md.erb
index 7988544c3..46c1bcee9 100644
--- a/website/source/docs/commands/validate.html.md.erb
+++ b/website/source/docs/commands/validate.html.md.erb
@@ -28,6 +28,10 @@ and supports `go-getter` syntax.
 On successful validation, exit code 0 will be returned, otherwise an exit code
 of 1 indicates an error.
 
+Service names are validated according to [RFC-1123](https://tools.ietf.org/html/rfc1123).
+Any environment variables in the name are ignored, because some environment variables can only
+be resolved in the node the job is run on.
+
 ## Examples
 
 Validate a job with invalid syntax: