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

[Quentin Schulz <quentin.schulz@cherry.de>]

Hi Robert,

On 6/23/26 7:43 PM, Robert P. J. Day via lists.yoctoproject.org 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.
> +

What standard tooling?

> +.. _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.
> +

I wouldn't know what makes a template and what they can be used for, 
should we point at 
documentation/dev-manual/custom-template-configuration-directory.rst for 
example?

>   .. _structure-meta-files:
> 
>   ``meta/files/``
> 
> 
> 
> -=-=-=-=-=-=-=-=-=-=-=-
> Links: You receive all messages sent to this group.
> View/Reply Online (#9843): https://lists.yoctoproject.org/g/docs/message/9843
> Mute This Topic: https://lists.yoctoproject.org/mt/119945115/6293953
> Group Owner: docs+owner@lists.yoctoproject.org
> Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [quentin.schulz@cherry.de]
> -=-=-=-=-=-=-=-=-=-=-=-
>