Re: [Audacity-manual] Tracking changes across pages

[Bill W. <bi...@go...>]

I have to agree with Ed as well. 

On 24/02/2012, at 6:01 PM, Bruno Gravato wrote:

> +1 on what Ed said.
> 
> On Fri, Feb 24, 2012 at 10:55 PM, Ed Musgrove
> <edg...@wa...>wrote:
> 

[snip]
>> 
>> The comments are almost always meaningless and almost never mention any GUI
>> changes:
>>       Correct error trap - compare with what we are expecting.
>>               Poor--no idea what might be going on.
>>       Improve font size and colour for track name in waveform pane
>>               Good--no doubt that it is a GUI change.
>>       Capitalize heading in line with current style
>>               suspect this might impact manual, but have to dig into the
>> code
>>       Moved /community/donate to its own tab.
>>               suspect this might impact manual, but have to dig into the
>> code
>> 
>> 

[snip]

>> The programmers need to create a rough draft covering the details when they
>> make code changes which affect the manual but they will not.
>> 
>> So, respectfully, "No, thanks!" Lobby the Programmers to consider the
>> manual, improve their commit comments and document code changes.

In my view the devs making commits don't need to specifically think about the manual, but a note on functional or UI changes in the commit would be useful.

-- Bill