moby
Include new allowed naming conventions for dockerignore
File: frontend/dockerfile/docs/reference.md
A coworker suggested new dockerignore files using the naming syntax that's suggested on https://docs.docker.com/engine/reference/commandline/build/#:~:text=will%20first%20look%20for%20an%20ignore%20file%20named. When I went to review it, I was unfamiliar with the syntax, and went to the linked file above, and was confused as it didn't look like it was supported, until they linked me to the second page linked here, which I'm not sure I'd have ever found on my own without getting lucky with google terms.
I'd like to suggest including the note from that second page on the first page:
When using the BuildKit backend, docker build searches for a .dockerignore file relative to the Dockerfile name. For example, running docker build -f myapp.Dockerfile . will first look for an ignore file named myapp.Dockerfile.dockerignore. If such a file is not found, the .dockerignore file is used if present. Using a Dockerfile based .dockerignore is useful if a project contains multiple Dockerfiles that expect to ignore different sets of files.
or maybe just a link from the first page to the second page?
