Merge 67fd9409c7 into 67dc78bbaf

docs: add validating build configuration example

README.md

@@ -80,12 +80,13 @@ jobs:
           tags: user/app:latest
 ```
 
-Be careful because **any file mutation in the steps that precede the build step
+**Important Considerations for Git Context**
-will be ignored, including processing of the `.dockerignore` file** since
+
-the context is based on the Git reference. However, you can use the
+* **File Mutations** perfomred during your workflow will **not** be reflected in the final Docker image.
-[Path context](#path-context) using the [`context` input](#inputs) alongside
+
-the [`actions/checkout`](https://github.com/actions/checkout/) action to remove
+* **.dockerignore** is ignored altogether when using git context.
-this restriction.
+
+You can remove these limitations by using the [path context](#path-context) input alongside the [`actions/checkout`](https://github.com/actions/checkout/) action.
 
 Default Git context can also be provided using the [Handlebars template](https://handlebarsjs.com/guide/)
 expression `{{defaultContext}}`. Here we can use it to provide a subdirectory
@@ -162,6 +163,7 @@ jobs:
 * [Cache management](https://docs.docker.com/build/ci/github-actions/cache/)
 * [Export to Docker](https://docs.docker.com/build/ci/github-actions/export-docker/)
 * [Test before push](https://docs.docker.com/build/ci/github-actions/test-before-push/)
+* [Validating build configuration](https://docs.docker.com/build/ci/github-actions/checks/)
 * [Local registry](https://docs.docker.com/build/ci/github-actions/local-registry/)
 * [Share built image between jobs](https://docs.docker.com/build/ci/github-actions/share-image-jobs/)
 * [Named contexts](https://docs.docker.com/build/ci/github-actions/named-contexts/)