RMS wrote:
> Would people please review this and make recommendations?

To me, it is a modern and very good text and guidance.

I appreciate in particular that it gives the individual GNU package maintainers
the freedom to find their best practice within the guidance: "It is up to you
to decide whether to allow your project's developers ..."

Three small issues:

1) The text mentions 'gitlog_to_changelog.py' from glibc. Meanwhile, this
   script is available from Gnulib, but there it is called 
'vcs_to_changelog.py'.

2) "Subversion, or Git, or Mercurial"
   It would be useful to mention Git first. It is by far the most popular VCS
   by now: In 2018, a poll among developers showed 87.2% use of Git,
   16.1% use of Subversion, and 3.6% use of Mercurial. [1]
   The GCC project just migrated from Subversion to Git recently.

3) Inconsistent spelling: The text has 2x "change set" and 3x "changeset".
   It seems that the majority spelling nowadays is "changeset"; likewise
   the Wikipedia page is https://en.wikipedia.org/wiki/Changeset .

Bruno

[1] https://insights.stackoverflow.com/survey/2018#development-practices


Reply via email to