Re: [OE-core] [PATCH 1/1] ref-manual: document KERNEL_SPLIT_MODULES variable

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

Hi Dixit,

On 6/5/25 3:58 PM, Dixit Parmar via lists.openembedded.org wrote:
> I had sent out this patch on docs@lists.yoctoproject.org ML with a different file earlier, they suggested to send it to OE-Core so I sent it here.
> I again sent this same patch to docs@lists.yoctoproject.org
> Looking forward to reviews.
> 

The original patch sent to yocto-docs mailing list was modifying a file 
from OE-Core so it should have been sent to OE-Core mailing list, even 
if it is "documentation".

As feedback to the original patch it was said it may have limited 
usefulness to have VAR[doc] and we should rather have the variable 
described in the variables glossary of the yocto documentation (or in 
both places). This now modifies a file that is part of the Yocto 
documentation and not OE-Core, so it shouldn't be sent to the OE-Core 
mailing list but the yocto-docs one.

Note that BitBake also has its own documentation, c.f. 
bitbake/documentation if you're looking from poky git repo.

Reading BitBake's README file you will see that patches for the BitBake 
documentation needs to be sent to both the BitBake and yocto-docs 
mailing list. The reason is simple for that: BitBake documentation gets 
reviewed by the documentation community (typically looking at yocto-docs 
mailing list only) but merged by the BitBake maintainer(s).

I know this isn't necessarily the clearest or easiest information to 
find so I hope this helps. Please let us know if you have suggestions on 
how to improve this.

Cheers,
Quentin