Re: [docs] [PATCH RFC 0/6] Generate documentation links for OE-Core (cover letter only)

"Antonin Godard" <[email protected]> Wed, 08 Jul 2026 12:03:45 +0200
Newsgroups org.yoctoproject.lists.docs
Message-ID <[email protected]>
Hi,

On Mon Jul 6, 2026 at 12:02 PM CEST, Paul Barker wrote:
[...]
>
> Hi Antonin,
>
> I think the idea is good! A couple of comments...
>
> I don't think we can set YOCTO_DOCS_DIR by default as there are many
> ways of setting up the source layers without cloning the docs repo. We
> would need a way to set this in toolcfg.conf via bitbake-setup when the
> chosen configuration includes yocto-docs. Then the include directive in
> bitbake.conf should be conditional on YOCTO_DOCS_DIR being set.

So this would require adding specific logic in bitbake-setup, I guess? I.e. make
bitbake-setup detect that we've included the documentation as part of our build
and set YOCTO_DOCS_DIR appropriately? Is this what you had in mind?

> Also looking at the gen-doc-links script, we should not use a Creative
> Commons license for scripts. We should use MIT or GPL.

Correct, I'll adjust that.

Thanks!
Antonin