Re: [docs] dev manual inconsistently encourages changing "poky" checkout locally

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

On Fri Jun 20, 2025 at 11:47 AM CEST, Alexander Kanavin via lists.yoctoproject.org wrote:
> On Fri, 20 Jun 2025 at 11:44, Robert P. J. Day <rpjday@crashcourse.ca> wrote:
>>   it's point 5 here:
>>
>> https://docs.yoctoproject.org/what-i-wish-id-known.html
>
> "Never modify the POKY layer. Never. Ever. When you update to the next
> release, you’ll lose all of your work. ALL OF IT."
>
> I'm not sure what this point wants to say to be honest. Can't make sense of it.

While the what-i-wish-id-known document is pretty clear about it, it's true that
saying "As you work with the local branch, you can periodically use the git pull
--rebase command to be sure you are up-to-date with the upstream branch." when
speaking about the poky repository kind of imply local modifications. And these
two documents are unrelated.

So all-in-all, I think what we want to remove here is the "--rebase" flag.
That's the only thing implying local modifications to poky. Using "git pull" is
fine. I'd take a patch.

Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com