dev-manual: update recommendations for build system

Drop the reference to "Xeon" and hard-coded RAM and disk space
recommendations and get those values from poky.yaml.in.

Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>

---

Hi Robert,

On 9/14/26 11:07 AM, Robert P. J. Day via lists.yoctoproject.org wrote:
> 
> Drop the reference to "Xeon" and hard-coded RAM and disk space
> recommendations and get those values from poky.yaml.in.
> 

Sounds good to me. We actually don't mention the kind of processors you 
should use in documentation/brief-yoctoprojectqs/index.rst.

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>

> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
> 
> ---
> 
> diff --git a/documentation/dev-manual/start.rst b/documentation/dev-manual/start.rst
> index 3b8e2334a..7def242e2 100644
> --- a/documentation/dev-manual/start.rst
> +++ b/documentation/dev-manual/start.rst
> @@ -55,9 +55,9 @@ particular working environment and set of practices.
>   #.  *Gather the Hardware:* Based on the size and make-up of the team,
>       get the hardware together. Ideally, any development, build, or test
>       engineer uses a system that runs a supported Linux distribution.
> -    These systems, in general, should be high performance (e.g. dual,
> -    six-core Xeons with 24 Gbytes of RAM and plenty of disk space). You
> -    can help ensure efficiency by having any machines used for testing
> +    These systems, in general, should be high performance (e.g. a minimum
> +    of &MIN_RAM; Gbytes of RAM and at least &MIN_DISK_SPACE; Gbytes of disk space.)

I'm wondering if we shouldn't simply replace the previous two sentences 
with:

[...] uses :ref:`a system that runs a supported Linux distribution 
<brief-yoctoprojectqs/index:compatible linux distribution Compatible 
Linux Distribution>`.
You can help ensure [...]

(not tested).

This would avoid the need of keeping them both in sync and would also 
list what those machines need to run as distro and which package they 
depend on.

What do you think?

Cheers,
Quentin

On Wed, 23 Sep 2026, Quentin Schulz wrote:

> Hi Robert,
>
> On 9/14/26 11:07 AM, Robert P. J. Day via lists.yoctoproject.org wrote:
> >
> > Drop the reference to "Xeon" and hard-coded RAM and disk space
> > recommendations and get those values from poky.yaml.in.
> >
>
> Sounds good to me. We actually don't mention the kind of processors you should
> use in documentation/brief-yoctoprojectqs/index.rst.
>
> Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>
>
> > Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
> >
> > ---
> >
> > diff --git a/documentation/dev-manual/start.rst
> > b/documentation/dev-manual/start.rst
> > index 3b8e2334a..7def242e2 100644
> > --- a/documentation/dev-manual/start.rst
> > +++ b/documentation/dev-manual/start.rst
> > @@ -55,9 +55,9 @@ particular working environment and set of practices.
> >   #.  *Gather the Hardware:* Based on the size and make-up of the team,
> >       get the hardware together. Ideally, any development, build, or test
> >       engineer uses a system that runs a supported Linux distribution.
> > -    These systems, in general, should be high performance (e.g. dual,
> > -    six-core Xeons with 24 Gbytes of RAM and plenty of disk space). You
> > -    can help ensure efficiency by having any machines used for testing
> > +    These systems, in general, should be high performance (e.g. a minimum
> > +    of &MIN_RAM; Gbytes of RAM and at least &MIN_DISK_SPACE; Gbytes of disk
> > space.)
>
> I'm wondering if we shouldn't simply replace the previous two sentences with:
>
> [...] uses :ref:`a system that runs a supported Linux distribution
> <brief-yoctoprojectqs/index:compatible linux distribution Compatible Linux
> Distribution>`.
> You can help ensure [...]
>
> (not tested).
>
> This would avoid the need of keeping them both in sync and would also list
> what those machines need to run as distro and which package they depend on.
>
> What do you think?

  i'll submit something equivalent later today.

rday