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
@@ -115,8 +115,8 @@
 . Submit the diff file using the web-based https://bugs.FreeBSD.org/bugzilla/enter_bug.cgi?product=Documentation[Problem Report] system. If using the web form, enter a Summary of _[patch] short description of problem_. Select the Component `Documentation`. In the Description field, enter a short description of the changes and any important details about them. Use the btn:[Add an attachment] button to attach the diff file. Finally, use the btn:[Submit Bug] button to submit your diff to the problem report system.
 ====
 
-[[gnu-linux-installation-process]]
-=== GNU/Linux installation process
+[[macOS-and-gnu-linux-installation-process]]
+=== macOS and GNU/Linux installation process
 
 [.procedure]
 ====
@@ -125,7 +125,22 @@
 Hugo version 0.90 or higher must be used
 ======
 
-. Install these packages in apt-based systems like Debian or Ubuntu.
+
+. *_For macOS_*
++
+Use Homebrew and RubyGem to install these packages.
++
+[source,shell]
+....
+$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+$ brew install hugo ruby git bmake asciidoctor
+$ echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
+$ sudo gem install rouge
+....
++
+*_For GNU/Linux_*
++
+Install these packages in apt-based systems like Debian or Ubuntu.
 On other GNU/Linux distributions the package names may change.
 Consult your distribution's package manager if in doubt.
 +