docs: add note about check with errors

Signed-off-by: Tonis Tiigi <[email protected]>
moby · Oct 7, 2024 · 885b1a5 · 885b1a5
1 parent 8c313f9
commit 885b1a5
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/frontend/dockerfile/docs/reference.md b/frontend/dockerfile/docs/reference.md
@@ -345,6 +345,11 @@ despite warnings. To make the build fail on warnings, set `#check=error=true`.
 # check=error=true
 ```
 
+> [!NOTE]
+> When using the `check` directive, with `error=true` option, it is recommended
+> to pin the [Dockerfile syntax]((#syntax)) to a specific version. Otherwise, your build may
+> start to fail when new checks are added in the future versions.
+
 To combine both the `skip` and `error` options, use a semi-colon to separate
 them: