Re: Doc: rename section in LM (3280) (issue 8575044)

[dak]

On 2013/04/12 10:26:46, mail_philholmes.net wrote:
> ----- Original Message -----
> From: <mailto:address@hidden>

> > I think "retouching" is pretty much on spot.  Asking the thesaurus
does
> > not really deliver anything more convincing:


> Sorry - I don't agree.  In native English, retouching has a strong
> connotation of dabbing something like paint over another patch of
> paint to correct something that doesn't look right.

And indeed, the very first actual code example in the "tweaks" section
changes notehead colours to green and red.

> PhotoShop-type programs are known for their retouching ability.  In
> contract, fine-tuning is taking something that's fairly OK as it is
> and making it better - exactly what we've considered to be a tweak.
> IMO fine-tuning is a perfectly acceptable description - retouching
> would not work.

How is coloring noteheads green and red "fine-tuning"?

I suspect you are objecting to the naming change without looking at
the actual contents of the section, just judging from its old name or
your memory.

The section isn't about fine-tuning (though it is helpful when
fine-tuning is your goal).  Indeed, since we don't want to rewrite the
section all the time just because LilyPond keeps getting better, the
examples in this section tend _not_ to be fine-tuning but rather
pretty thorough changes.  Changes that won't get redundant when
LilyPond gets better.

There _has_ been more documentation of fine-tuning changes in historic
times but many of them got thrown out eventually because they stopped
having an effect or made things worse as LilyPond got better out of
the box.


https://codereview.appspot.com/8575044/