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
@@ -51,6 +51,11 @@
 ePub file format.
 |===
 
+[NOTE]
+====
+On macOS and Linux, GNU Make doesn't work due to the syntax differrence. Users have to install bmake(Berkerly Make) manually.
+====
+
 [[doc-build-rendering-html]]
 === Rendering to html
 
@@ -122,7 +127,7 @@
 
 These are the tools used to build and install the FDP documentation.
 
-* The primary build tool is man:make[1], specifically Berkeley Make.
+* The primary build tool is man:make[1], specifically Berkeley Make. Therefore, bmake should be installed and used on macOS and Linux.
 * Python is used to generate the Table of Contents and other related Tables.
 * Hugo
 * AsciiDoctor
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
@@ -85,6 +85,8 @@
 % make
 ....
 +
+On macOS and Linux, install and use bmake because GNU Make doesn't work due to the differeces of sytax.
++
 . When changes are complete and tested, generate a "diff file":
 +
 [source,shell]