Re: Paying off tech debt and correctly naming things

2018-03-28 Thread Jonathan Haddad
As requested, I'm alerting the ML that I've got the first patch of several to come. This one only addresses the ColumnFamilyStore class - and only changes the name. There's follow up tickets to change method and variable names. As we agreed, I'm doing this incrementally, so please let's keep tha

RE: Paying off tech debt and correctly naming things

2018-03-22 Thread Kenneth Brotman
Perfect! -Original Message- From: Jon Haddad [mailto:jonathan.had...@gmail.com] On Behalf Of Jon Haddad Sent: Thursday, March 22, 2018 8:10 AM To: dev@cassandra.apache.org Subject: Re: Paying off tech debt and correctly naming things Cool. I think there’s general agreement that doing

RE: Paying off tech debt and correctly naming things

2018-03-22 Thread Kenneth Brotman
From: Jason Brown [mailto:jasedbr...@gmail.com] Sent: Thursday, March 22, 2018 7:14 AM To: dev@cassandra.apache.org Subject: Re: Paying off tech debt and correctly naming things Jon, Thanks for bringing up this topic. I'll admit that I've been around this code base for long enough,

Re: Paying off tech debt and correctly naming things

2018-03-22 Thread Jon Haddad
Cool. I think there’s general agreement that doing this in as small bites as possible is going to be the best approach. I have no interest in mega patches. > The combined approach takes a > change that's already non-trivially dealing with complex subsystem > changes and injects a bunch of t

Re: Paying off tech debt and correctly naming things

2018-03-22 Thread Jason Brown
Jon, Thanks for bringing up this topic. I'll admit that I've been around this code base for long enough, and have enough accumulated history, that I probably can't fully appreciate the impact for a newcomer wrt naming. However, as Josh points out, this situation probably happens to "every non-triv

Re: Paying off tech debt and correctly naming things

2018-03-22 Thread Josh McKenzie
> Some of us have big patches in flight, things that actually > pay off some technical debt, and dealing with such renames is rebase hell :\ For sure, but with a code-base this old / organically grown, I expect this will always be the case. If we're talking something as simple as an intellij rename

Re: Paying off tech debt and correctly naming things

2018-03-22 Thread Aleksey Yeshchenko
Poor and out-of-date naming of things is probably the least serious part of our technical debt. Bad factoring, and straight-up poorly written components is where it’s really at. Doing a big rename for rename sake alone does more harm than it is good, sometimes. Some of us have big patches in fli

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread Dinesh Joshi
Having been through a bunch of refactors in other projects, I would suggest doing small incremental patches isolated in related parts of the code. It would also be nice if you could give us a heads up on changes you're making. Best of luck! Dinesh On Tuesday, March 20, 2018, 3:04:43 PM PDT,

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread Rahul Singh
+1 - can help with sections of the code -- Rahul Singh rahul.si...@anant.us Anant Corporation On Mar 21, 2018, 4:25 PM -0500, Lerh Chuan Low , wrote: > For reasons others have mentioned (nightmare to continuously update branch > and resolve merge conflicts, existing patches/big features..) it wi

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread Jeff Jirsa
Please please please ping the list and ask if anyone has big commits ready to merge before actually committing any huge automated refactors - people who may be sitting on big patches will thank you if they don’t have to rebase against huge IntelliJ refactors . -- Jeff Jirsa > On Mar 21, 201

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread Jeremiah D Jordan
+1 if you are willing to take it on. As the person who performed the Table->Keyspace rename of 2.0, I say good luck! From hindsight of doing that, as others suggested, I would come at this in multiple tickets. I would suggest a simple class rename with intellij refactoring tools or something a

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread Lerh Chuan Low
For reasons others have mentioned (nightmare to continuously update branch and resolve merge conflicts, existing patches/big features..) it will be a nightmare. It seems like in software projects (just basing it off personal experience) people typically refactor if a ticket they are working on touc

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread Eric Evans
On Wed, Mar 21, 2018 at 3:48 AM, Sylvain Lebresne wrote: [ ... ] > - pure code renaming is one reasonably simple aspect, but quite a few > renaming may have user visible impact. Particularly around JMX where many > things are name based on their class, and to a lesser extend some of our > tools

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread Sylvain Lebresne
I really don't think anyone has been recently against such renaming, and in fact, a _lot_ of renaming *has* already happen over time. The problem, as you carefully noted, is that it's such a big task that there is still a lot to do. Anyway, I've yet to see a patch renaming things to match the CQL n

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread Benjamin Lerer
I agree that the refactoring make sense but I also know the pain of merging branches with smaller refactorings. When you have to make a patch for several branches and that you have to go through several round of reviews it can be pretty painful. I know that pain too well so I am not in favor of the

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread kurt greaves
As someone who came to the codebase post CQL but prior to thrift being removed, +1 to refactor. The current mixing of terminology is a complete nightmare. This would also give a good opportunity document a lot of code that simply isn't documented (or incorrect). I'd say it's worth doing it in multi

Re: Paying off tech debt and correctly naming things

2018-03-21 Thread DuyHai Doan
+10 There are 2 hard problems in CS: naming things and cache invalidation Le 20 mars 2018 23:04, "Jon Haddad" a écrit : > Whenever I hop around in the codebase, one thing that always manages to > slow me down is needing to understand the context of the variable names > that I’m looking at. We’