Re: [docs] [PATCH 1/8] conf.py: define new {oecore,bitbake,meta_yocto}_rev roles

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

Hi,

On Thu Mar 5, 2026 at 11:56 AM CET, Quentin Schulz wrote:
> Hi Antonin,
>
> On 3/2/26 10:37 AM, Antonin Godard via lists.yoctoproject.org wrote:
>> Use the extlinks extension to create new roles to quickly reference a
>> commit from openembedded-core, bitbake, or meta-yocto.
>> 
>> For example, use as: :oecore_rev:`437e0419608e`.
>> 
>> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
>> ---
>>   documentation/conf.py | 16 +++++++++++++---
>>   1 file changed, 13 insertions(+), 3 deletions(-)
>> 
>> diff --git a/documentation/conf.py b/documentation/conf.py
>> index 5a69977cf..f3234b241 100644
>> --- a/documentation/conf.py
>> +++ b/documentation/conf.py
>> @@ -91,9 +91,17 @@ rst_prolog = """
>>   .. |author| replace:: %s
>>   """ % (project, copyright, author)
>>   
>> +# base url definitions
>> +oe_git_baseurl = "https://git.openembedded.org/"
>> +oecore_git_baseurl = f"{oe_git_baseurl}/openembedded-core"
>> +bitbake_git_baseurl = f"{oe_git_baseurl}/bitbake"
>> +yocto_git_baseurl = "https://git.openembedded.org/"
>
> Well, thanks to my company's wonderful mail server this is broken but... 
> this should be git.yoctoproject.org and not git.openembedded.org.

Darn, thanks for spotting that.

>> +meta_yocto_baseurl = f"{yocto_git_baseurl}/meta-yocto"
>> +
>
> Small nitpick here, I think we should make it easier to distinguish the 
> server URLs from the repo URLs.
>
> What about something like
>
> oe_git_server = "https://git.openembedded.org/"
> oecore_git_baseurl = f"{oe_git_server}/openembedded-core"
>
> for example?
>
> Not sure we need _baseurl, it's kinda implied if we have oecore_git?

I'll take your suggestion, thanks!

Antonin