From 937ce69b4251d355db64eb88715ced76ed04b157 Mon Sep 17 00:00:00 2001 From: Brandon Mitchell Date: Thu, 10 Oct 2019 17:03:48 -0400 Subject: [PATCH] Adjusting glossary reference and clarrifying the start of a Dockerfile Signed-off-by: Brandon Mitchell --- docs/reference/builder.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/reference/builder.md b/docs/reference/builder.md index 2b24052255..c400bafbd5 100644 --- a/docs/reference/builder.md +++ b/docs/reference/builder.md @@ -157,10 +157,12 @@ be UPPERCASE to distinguish them from arguments more easily. Docker runs instructions in a `Dockerfile` in order. A `Dockerfile` **must -start with a \`FROM\` instruction**. The `FROM` instruction specifies the [*Base -Image*](glossary.md#base-image) from which you are building. `FROM` may only be -preceded by one or more `ARG` instructions, which declare arguments that are used -in `FROM` lines in the `Dockerfile`. +begin with a \`FROM\` instruction**. This may be after [parser +directives](#parser-directives), [comments](#format), and globally scoped +[ARGs](#arg). The `FROM` instruction specifies the [*Parent +Image*](glossary.md#parent-image) from which you are building. `FROM` +may only be preceded by one or more `ARG` instructions, which declare arguments +that are used in `FROM` lines in the `Dockerfile`. Docker treats lines that *begin* with `#` as a comment, unless the line is a valid [parser directive](#parser-directives). A `#` marker anywhere