Re: [docs] [PATCH] ref_manual: add "fragments" and "templates" directories to structure

["Antonin Godard" <antonin.godard@bootlin.com>]

Hi,

On Tue Jun 23, 2026 at 7:43 PM CEST, Robert P. J. Day wrote:
>
> Add two new entries for the meta/conf/{fragments,templates}
> directories to the structure of OE-Core metadata.
>
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
>
> ---
>
>   I didn't bother with the "multiconfig" directory since all it
> contained was an empty default.conf file. So let's just go with these.
>
> diff --git a/documentation/ref-manual/structure.rst b/documentation/ref-manual/structure.rst
> index ff84b250b..96f9c9f34 100644
> --- a/documentation/ref-manual/structure.rst
> +++ b/documentation/ref-manual/structure.rst
> @@ -862,6 +862,25 @@ it is possible to extend that support to other SDK hosts by adding
>  additional configuration files in this subdirectory within another
>  layer.
>
> +.. _structure-meta-conf-fragments:
> +
> +``meta/conf/fragments/``
> +~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +This directory contains a number of
> +:term:`configuration fragments <Configuration Fragment>` ---
> +top-level build configuration features that can be independently enabled
> +and disabled using standard tooling.

s/using standard tooling/using the :bitbake_path:`bitbake-config-build <bin/bitbake-config-build>` utility/

Can you add a link to the reference manual's fragment section here please?
(documentation/ref-manual/fragments.rst)

> +
> +.. _structure-meta-conf-templates:
> +
> +``meta/conf/templates/``
> +~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +This directory contains default templates to be used as initial files
> +such as ``local.conf``, ``bblayers.conf`` and other files when
> +initializing a new Yocto Project build.

Please cross link to documentation/dev-manual/custom-template-configuration-directory.rst

Antonin