diff --git a/site/en/concepts/build-files.md b/site/en/concepts/build-files.md
index 9bcc8d29d9af16..ea133fd6886f21 100644
--- a/site/en/concepts/build-files.md
+++ b/site/en/concepts/build-files.md
@@ -10,7 +10,14 @@ build dependency graph abstractly. This section describes the concrete syntax
 used to define a package.
 
 By definition, every package contains a `BUILD` file, which is a short
-program. `BUILD` files are evaluated using an imperative language,
+program.
+
+Note: The `BUILD` file can be named either `BUILD` or `BUILD.bazel`. If both
+files exist, `BUILD.bazel` takes precendence over `BUILD`.
+For simplicity’s sake, the documentation refers to these files simply as `BUILD`
+files.
+
+`BUILD` files are evaluated using an imperative language,
 [Starlark](https://github.com/bazelbuild/starlark/){: .external}.
 
 They are interpreted as a sequential list of statements.
diff --git a/site/en/concepts/build-ref.md b/site/en/concepts/build-ref.md
index 0849177ec9916a..c9b87b38112116 100644
--- a/site/en/concepts/build-ref.md
+++ b/site/en/concepts/build-ref.md
@@ -49,11 +49,11 @@ The primary unit of code organization in a repository is the _package_. A
 package is a collection of related files and a specification of how they can be
 used to produce output artifacts.
 
-A package is defined as a directory containing a file named `BUILD` (or
-`BUILD.bazel`). A package includes all files in its directory, plus all
-subdirectories beneath it, except those which themselves contain a `BUILD` file.
-From this definition, no file or directory may be a part of two different
-packages.
+A package is defined as a directory containing a
+[`BUILD` file](/concepts/build-files) named either `BUILD` or `BUILD.bazel`. A
+package includes all files in its directory, plus all subdirectories beneath it,
+except those which themselves contain a `BUILD` file. From this definition, no
+file or directory may be a part of two different packages.
 
 For example, in the following directory tree there are two packages, `my/app`,
 and the subpackage `my/app/tests`. Note that `my/app/data` is not a package, but