git: 1aadaf5e4a - main - Improve documentation build instructions

From: Sergio Carlavilla Delgado <carlavilla_at_FreeBSD.org>
Date: Fri, 17 Feb 2023 18:50:09 UTC
The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=1aadaf5e4a1c7b4792cebd628268b14fdd97e622

commit 1aadaf5e4a1c7b4792cebd628268b14fdd97e622
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2023-02-17 18:47:45 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-02-17 18:47:45 +0000

    Improve documentation build instructions
    
    With some minor improvements from the GitHub PR
    
    Reported by:    Gaelan Lloyd
    Pull Request:   https://github.com/freebsd/freebsd-doc/pull/110
---
 .../content/en/books/fdp-primer/overview/_index.adoc        | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/documentation/content/en/books/fdp-primer/overview/_index.adoc b/documentation/content/en/books/fdp-primer/overview/_index.adoc
index 6b1ce7554a..accae70a53 100644
--- a/documentation/content/en/books/fdp-primer/overview/_index.adoc
+++ b/documentation/content/en/books/fdp-primer/overview/_index.adoc
@@ -129,13 +129,24 @@ These people can help with questions or problems involving the documentation.
 Review the output and edit the file to fix any problems shown, then rerun the command to find any remaining problems.
 Repeat until all of the errors are resolved.
 +
-. *_Always_* build and test the changes before submitting them. Running `make` in the `documentation` or `website` subdirectories will generate the documentation in HTML format.
+. *_Always_* build and review the changes before submitting them. Running `make` in the `documentation` or `website` subdirectories will generate the documentation in HTML format.
 +
 [source,shell]
 ....
 % make
 ....
 +
+To reduce compile time, only one language can be compiled:
++
+[source,shell]
+....
+% make DOC_LANG=en
+....
++
+The build output is stored in [.filename]#~/documentation/public/articles/`# and [.filename]#`~/documentation/public/books/`#.
++
+. Review the build output and ensure the edits are free from typos, layout problems, or errors. If any errors are found during the build process, edit the problematic files to fix any issues that show up, then run the build command again until all errors are resolved.
++
 . Add all the files with `git add .`, then review the diff with `git diff`. For example:
 +
 [source,shell]