[ovs-dev] NEWS vs. ChangeLog
Justin Pettit
jpettit at nicira.com
Sun Aug 7 16:58:51 PDT 2011
I suspect you may be over-thinking it, since I think most people just don't read documentation. :) However, if it saves even one question, it's worth it. In any case, it is probably a more appropriate title for what it includes.
Thanks,
--Justin
On Aug 4, 2011, at 9:50 PM, Ben Pfaff wrote:
> I've noticed that many users seem to miss changes that we clearly state
> in ChangeLog. Some of this is probably due to users not reading any
> documentation ever, but I wonder whether some of it is because users
> expect ChangeLog to be akin to a commit log, because that's what GNU
> software puts in ChangeLog. Users don't read GNU ChangeLogs, because
> they don't contain information useful to users.
>
> GNU software puts what we have in ChangeLog in a file named NEWS. Some
> users read it. Therefore: would you mind if we renamed ChangeLog to
> NEWS?
>
> Thanks,
>
> Ben.
More information about the dev
mailing list