Re: Bug Numbers and Trac Numbers in comments

2019-02-21 Thread Kirk Lund
I didn't write this test, but I did rename it from Bug42226Test to PersistentPartitionHangsDuringRestartRegressionTest and do some additional cleaning to bring it up to minimal standards. Please feel free to file a PR that removes all Jira and Trac ticket #s from the codebase (or parts of it). On

Re: Bug Numbers and Trac Numbers in comments

2019-02-20 Thread Bruce Schuchardt
+1 We shouldn't even reference Apache JIRA tickets.  References to outside things like Trac tickets, JIRA tickets or even commit SHAs become outdated over time. On 2/20/19 11:28 AM, Alexander Murmann wrote: I think it's important that we enable everyone in the community to be equally successfu

Re: Bug Numbers and Trac Numbers in comments

2019-02-20 Thread Alexander Murmann
I think it's important that we enable everyone in the community to be equally successful and on top of that do NOT rely on non-Apache resources. If we find value in Trac numbers, we should either find a way to make them accessible to everyone or update the comment so that there is no value in knowi

Re: Bug Numbers and Trac Numbers in comments

2019-02-20 Thread Kirk Lund
Well, the problem is that different people disagree on what's "meaningful" in this context. For example: See PersistentPartitionHangsDuringRestartRegressionTest.java * /*** * * RegressionTest for bug 42226. * * * 1. Member A has the bucket * * * 2. Member B starts creating the bucket. It t

Re: Bug Numbers and Trac Numbers in comments

2019-02-20 Thread Ken Howe
+1 - What Jake said. > On Feb 19, 2019, at 5:21 PM, Jacob Barrett wrote: > > Comments that don’t provide meaningful context beyond what is already > expressed in the code should be removed. A number to a system that the > general public can’t access is not meaningful. Delete or replace with

Re: Bug Numbers and Trac Numbers in comments

2019-02-19 Thread Jacob Barrett
Comments that don’t provide meaningful context beyond what is already expressed in the code should be removed. A number to a system that the general public can’t access is not meaningful. Delete or replace with meaningful comment. -jake > On Feb 19, 2019, at 1:41 PM, Michael Oleske wrote: >