Bug ID: 291202
           Summary: fdp-primer overview misleadingly omits where website
                    build output is stored
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: bigsneaky@duck.com

The fourth section of the FreeBSD Documentation Project Primer "Quick Start"
guide (part of the Overview chapter) discusses how to build both documentat=
ion
and website subdirectories:

https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/b=
ooks/fdp-primer/overview/_index.adoc

> Always build and review the changes before submitting them.
> Running make in the documentation or website subdirectories
> will generate the documentation in HTML format.
> % make
> To reduce compile time, only one language can be compiled:
> % make DOC_LANG=3Den
> The build output is stored in ~/doc/documentation/public/en/articles/
> and ~/doc/documentation/public/en/books/.

The final statement seems to suggest all the previously discussed output - =
from
both the documentation and website subdirectories - will be stored in the t=
wo
stated directories. But build output from the website subdirectory is store=
d in
~/doc/website/public, which is not mentioned anywhere in the Overview chapt=
er.

--=20
You are receiving this mail because:
You are the assignee for the bug.=