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

Quentin Schulz <[email protected]>
Newsgroups org.yoctoproject.lists.docs
Message-ID <[email protected]>

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?

> rday
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.