Re: [Libreoffice] Easy Hacks "remove all the bogus comments lying around"

Should the issue number be left in the comment as well or not?

--Zell Faze


--- On Tue, 9/28/10, Kohei Yoshida <kyoshida@novell.com> wrote:

> From: Kohei Yoshida <kyoshida@novell.com>
> Subject: Re: [Libreoffice] Easy Hacks "remove all the bogus comments lying around"
> To: libreoffice@lists.freedesktop.org
> Date: Tuesday, September 28, 2010, 11:13 PM
> On Wed, 2010-09-29 at 01:28 +0200,
> Regina Henschel wrote:
> > Hi all,
> >
> > I saw some comments removed, which had a issue number.
> But I'm not sure 
> > about doing that. I think it is useful to know, why
> the code has been 
> > changed and why in that particular way and issues
> sometimes contain a 
> > lot of additional information. I agree that the type
> "internal task" is 
> > useless, because we have no access to it. But links to
> issues in the 
> > normal issue tracker should not be deleted.
>
> Yes, Regina raises a good point.
>
> Those comments that include "issue numbers" - numbers that
> look like
> #i12345#, i#12345 should probably be left behind since they
> can be
> informative.
>
> For those of you who are not familiar, an issue number
> corresponds with
> a bug filed against OpenOffice.org, which can be traced
> back as 
>
> http://www.openoffice.org/issues/show_bug.cgi?id=12345
>
> with the '12345' being the issue number in this case.
>
> Kohei
>
> -- 
> Kohei Yoshida, Go-OO hacker, Calc
> <kyoshida@novell.com>
>
> _______________________________________________
> LibreOffice mailing list
> LibreOffice@lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/libreoffice