Date: Mon, 30 Oct 2006 23:29:17 +0300 From: "Andrew Pantyukhin" <infofarmer@FreeBSD.org> To: "Doug Barton" <dougb@freebsd.org> Cc: Ion-Mihai IOnut Tetcu <itetcu@freebsd.org>, freebsd-ports@freebsd.org, Christopher Boumenot <boumenot@gmail.com> Subject: Re: port_history - track port commit message comments Message-ID: <cb5206420610301229w32a0e9b2gc03cf883311804c5@mail.gmail.com> In-Reply-To: <45464ADF.7040201@FreeBSD.org> References: <ehs1qk$6pa$1@sea.gmane.org> <cb5206420610270526p56bf0457i8e780b948a392d05@mail.gmail.com> <20061027231646.5b07bd8f@it.buh.tecnik93.com> <cb5206420610271404hbb3ba6an99377535ebe1af98@mail.gmail.com> <20061028002501.32f5b845@it.buh.tecnik93.com> <45464ADF.7040201@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 10/30/06, Doug Barton <dougb@freebsd.org> wrote: > Ion-Mihai IOnut Tetcu wrote: > > > The problem with the OP's work is that some submitters/commiters think > > that the CVS commit message should document the _port_ changes while > > others think it should also document (or at least provide pointers) to > > the changes in the software itself > > Good commit messages should do both. > > On the other hand, there is no substitute for the user/admin thinking > for themselves. I think that if we try to overengineer making things > foolproof, the universe will simply conspire to create "better" fools. This is not only for communication between porter and user, but also between porters. I'm sure good porter should be perfectly content in total isolation, but some porters love each other so much, they can only be happy when they're in touch. Documenting your thoughts when you're hacking a port trying to get it right is extremely important. This is the first, vital step on the road to effective collaboration. Wiki, articles, manpages, mailing lists, IRC and other methods of communications help immensely, but unfortunately they all get but a fraction of your thoughts for a bunch of reasons.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?cb5206420610301229w32a0e9b2gc03cf883311804c5>