Re: NEWS file

2007-12-10 Thread Micah Cowan
-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-


NEWS file

2007-12-10 Thread Hrvoje Niksic
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.

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.