diff --git a/documentation/content/en/books/fdp-primer/doc-build/_index.adoc b/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
--- a/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
@@ -74,6 +74,12 @@
 ePub file format.
 |===
 
+[NOTE]
+====
+On macOS and Linux, GNU Make doesn't work due to the syntax difference.
+Users have to install bmake (Berkeley Make) manually.
+====
+
 [[doc-build-rendering-html]]
 === Rendering to html
 
@@ -214,6 +220,7 @@
 These are the tools used to build and install the FDP documentation.
 
 * The primary build tool is man:make[1], specifically Berkeley Make.
+** Therefore, bmake should be installed and used on macOS and Linux.
 * Hugo
 * AsciiDoctor
 * Git
diff --git a/documentation/content/en/books/fdp-primer/overview/_index.adoc b/documentation/content/en/books/fdp-primer/overview/_index.adoc
--- a/documentation/content/en/books/fdp-primer/overview/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/overview/_index.adoc
@@ -98,6 +98,8 @@
 % make
 ....
 +
+On macOS and Linux, install and use bmake because GNU Make doesn't work due to the syntax differences.
++
 . When changes are complete and tested, generate a "diff file":
 +
 [source,shell]