[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: do not do this



On Fri, Feb 14, 2003 at 04:47:58AM +0900, Masayuki Hatta wrote:
> Hmm, believe or not I've read Developer's Reference...
> 
> Anyway I found the correspond sentence in Developer's Reference 5.6.5,
> but I think the representation there is a little bit vague.  How about
> changing it something like this:
> 
>  Bear in mind that it is not obligatory to close bugs using the changelog like
>  described above -- if you simply want to close bugs that don't have anything to
>  do with an upload of yours, do it simply by emailing an explanation to
> -XXX-done@bugs.debian.org.
> +XXX-done@bugs.debian.org.  In other words, you should not close bugs in this way
> +if you want to close bugs which are not directly fixed in this package release.

This whole paragraph was not there in the developer's reference four months
ago. I believe that you've been a developer for longer, so you probably read
it before. I also believe that if you had actually seen the above paragraph
earlier, you probably wouldn't be pointing it out as vague today. :)

The developer's reference is a large document. We can plaster a section with
a slew of censure about this, but it won't necessarily have any positive
impact. When people read a large manual, they will usually not read all of
it carefully, regardless of whether it's crystal clear or bordering
incomprehensible.

Having said that, I will add another sentence to that paragraph.
I'm not sure it will do much good, but it doesn't hurt, either.

-- 
     2. That which causes joy or happiness.



Reply to: