Re: Issue 1463 in lilypond: Writing metadata to the PDF file

[Reinhold Kainhofer]

> Comment #8 on issue 1463 by percival.music.ca: Writing metadata to the
> PDF file
> 
> This has been raised a few times, and will be discussed in GOP.      At the
> moment,
> - undoc'd new features do not block a stable release
> - we can see alterations to regtests with diff, and therefore figure out
> what's new since 2.12.3.

Not always. That mainly holds for bugfixes, while most new features will add a 
new regtest, which does not show up in the diff.


Another aspect to consider is that the developer bestk knows what a new feature 
is about and how and in which musical context to use it. A doc writer, on thze 
other hand might not have any idea where the feature can be used (because it is 
from an area where he is not proficient) and how important it really is. So I 
would prefer it if the developer writes some raw documentation, which can then 
be improved by a dedicated doc writer. That way, the dev ensures that all 
important information about the feature is in the docs, while the doc writer 
ensures that users will understand it.

Cheers,
Redinhold