Best Practices for Renaming, Refactoring, and Breaking Changes with Teams

Posted by David in Dakota on Programmers See other posts from Programmers or by David in Dakota
Published on 2011-02-25T16:52:02Z Indexed on 2011/02/25 23:33 UTC
Read the original article Hit count: 978

Filed under:
|

What are some Best Practices for refactoring and renaming in team environments? I bring this up with a few scenarios in mind:

  1. If a library that is commonly referenced is refactored to introduce a breaking change to any library or project that references it. E.g. arbitrarily changing the name of a method.

  2. If projects are renamed and solutions must be rebuilt with updated references to them.

  3. If project structure is changed to be "more organized" by introducing folders and moving existing projects or solutions to new locations.

Some additional thoughts/questions:

  1. Should changes like this matter or is resulting pain an indication of structure gone awry?

  2. Who should take responsibility for fixing errors related to a breaking change? If a developer makes a breaking change should they be responsible for going into affected projects and updating them or should they alert other developers and prompt them to change things?

  3. Is this something that can be done on a scheduled basis or is it something that should be done as frequently as possible? If a refactoring is put off for too long it is increasingly difficult to reconcile but at the same time in a day spending 1 hour increments fixing a build because of changes happening elsewhere.

  4. Is this a matter of a formal communication process or can it be organic?

© Programmers or respective owner

Related posts about best-practices

Related posts about refactoring