-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Hrvoje Niksic wrote:
> I've noticed that the NEWS file now includes contents that would
> previously not have been included. NEWS was conceived as a resource
> for end users, not for developers or distribution maintainers. (Other
> GNU software seems to follow a similar policy.) I tried hard to keep
> it readable by only including important or at least relevant entries,
> sorted roughly by descending importance. Developer information can be
> obtained through other means: the web page, the version control logs,
> and the detailed ChangeLogs we keep.
>
> The recent entries were added to the front, without regard for
> relative importance. For example, NEWS now begins with announcement
> of the move to Mercurial, the new Autoconf 2.61 requirement, and the
> removal of "PATCH" and "TODO" files (!). These entries are relevant
> to developers, but almost completely meaningless to end users.
Very good point. I agree wrt PATCH, TODO and Autoconf. As to Mercurial,
it replaces the already-present entry regarding our move to Subversion,
and I believe it is of interest to non-developers, who want to know
where the latest source is. Certainly to the "casual" developer, who
will want to know where to find the code to submit patches against (I
want to try to discourage submission of patches against just "the latest
release", as I tend to get).
> If there is a need to include developer information in NEWS, I suggest
> that it be pushed to the bottom of the list, perhaps under a
> "Development information" section.
Developer information, for the most part, should probably go in the
Wgiki, when appropriate.
- --
Micah J. Cowan
Programmer, musician, typesetting enthusiast, gamer...
http://micah.cowan.name/
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
iD8DBQFHXUKj7M8hyUobTrERAnXnAJwLm99wHmGoWp4sibero2sUDXhsmgCfbIdY
8Dv+CyXH1p4moGbD5HUaU2w=
=HTWe
-END PGP SIGNATURE-