diff --git a/documentation/content/en/books/fdp-primer/doc-build/_index.adoc b/documentation/content/en/books/fdp-primer/doc-build/_index.adoc
index 146f32ad11..a76a3dcd8f 100644
--- 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 @@ Different types of output can be produced from a single AsciiDoc source file.
 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 @@ In order to export the document correctly all the extensions should be passed us
 
 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
index 77623625fb..cca2902243 100644
--- a/documentation/content/en/books/fdp-primer/overview/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/overview/_index.adoc
@@ -85,6 +85,8 @@ Repeat until all of the errors are resolved.
 % 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]