Re: [docs] why not rename "Maintaining Build Output Quality" to "buildhistory"?

On Wed, 24 Jun 2026, Quentin Schulz wrote:

>
>
> On 6/24/26 11:35 AM, Robert P. J. Day wrote:
> > On Wed, 24 Jun 2026, Quentin Schulz wrote:
> >
> > > On 6/24/26 10:21 AM, Robert P. J. Day via lists.yoctoproject.org wrote:
> > > >
> > > > while this section is titled "Maintaining Build Output Quality":
> > > >
> > > >     https://docs.yoctoproject.org/dev-manual/build-quality.html
> > > >
> > > > it's really solely about how to use "buildhistory", so why not just
> > > > call it something like "How to use YP buildhistory"? the title seems a
> > >
> > > OK but why would I want to use buildhistory? How do I hear about
> > > buildhistory
> > > in the first place?
> > >
> > > > bit misleading and even a little inaccurate.
> > > >
> > >
> > > What's misleading or inaccurate about it?
> > >
> > > """
> > > The buildhistory class helps you maintain the quality of your build
> > > output.
> > > """
> > >
> > > This matches the title of the section (which appears in the navigation
> > > panel
> > > on the left.
> >
> >    because the title suggests a more general approach to maintaining
> > build quality when the section covers only buildhistory. so why not
> > just title it that way?
> >
>
> You're looking for ways to improve build quality, will you read a section
> called "How to use buildhistory" when looking for that?

  no, but if i was interested in how to use build history, i would
read a section called "How to Use Build History". you know, the same
way that, if i wanted to know how to test my packages with ptest, i'd
consult a section called "Testing Packages with ptest":

https://docs.yoctoproject.org/test-manual/ptest.html#

  i don't understand why you so object to titling sections for what
they actually do.

rday