bug#20328: outdated CONTRIBUTE info re ChangeLogs

[Dmitry Gutov]

On 04/15/2015 07:52 PM, Glenn Morris wrote:

> IMO the file should be rewritten to explain that commit logs are to be
> written in the style of ChangeLogs.

Updated, please take a look.

> > This still applies. Even though it could say "in commit messages",
> > this also emphasized the fact that the same non-sandardized references
> > will appear in the ChangeLog file.
>
> s/could/should.

I'd prefer not to touch this part until the following is resolved.

> I guess we are supposed to use those silly "action stamps", but
> understandably no-one does. I'm sure people are going to keep using
> hashes in commit logs, which will be meaningless in the generated C'log.

Agreed: it's a nuisance. And since it relatively trivial to convert 
commit hashes to the action stamps or whatever when generating 
ChangeLogs, it makes sense to use hashes in the commit messages. Maybe 
prefixed with "git:", if someone is worried about ambiguity.

> If they are in a commit all of their own, you can use the "; " prefix to
> omit that entire commit log entry from the generated C'log.

I think it's also improved now.