Skip to main content

The 'Rewrite' vs the 'Refactor'

Sometimes you will come across a codebase / application that looks in such a mess or so old that the only option is to do a full rewrite. The code is horrible and out of date, it's using an old version of a language / framework and everyone has forgotten how it works. Everyone agrees, it will be much faster to just throw it away and start again.

This seems to be how so many software projects start. Over my career I know that I've been heard to say those very things myself. It's seductive, we all love a nice green field project and the big rewrite is the easiest way to turn a boring, difficult brown field project into something everyone wants to work on.

The hard truth is that I can only think of one (smallish) rewrite that I've worked on that could be classed as success and that company is no longer around (but I don't think the two things were related). More often than not, after we've finished the project (late, normally very late) our first thoughts are 'Now, if we could just have just another 2 months we could rewrite it from scratch (again) it would be so much better". Unsurprisingly most business don't respond overly positively to those sorts of requests!

Now when we're considering a re-write I'm trying very hard to work to the following process:

  • Estimate how long the legacy application will take to refactor to the desired quality / level of maintainability. At this point, double that estimate and if the business can afford that amount of time, then you're good to go with the full rewrite (over the refactoring). Of course you might ship the first version faster than that, but we all know that it's about version 3.0 that we get the desired functionality, stability and performance - rewrites generally aren't any different.
  • When there just doesn't seem to be any way to refactor an application, you've not looked hard enough. Go back to the drawing board and try again. Maybe the UI needs to be rewritten as you're moving from a technology that is no longer supported, but the business / domain logic can probably be reused. If that needs to be rewritten, do that in a later project in smaller chunks. Sure, it may take a while but do your estimates for the refactor approach and refer back to the first point.

If you're still not convinced (you might have to live the disappointment of seeing what a v1.0 of a rewrite looks like), then the additional benefits of the refactor approach are:

  • The only functionality missing from the final application will be depreciated functionality that the business agrees is no longer needed.
  • It should be possible to ship the application incrementally through-out the refactoring. If it's not, are you sure you're not just doing a re-write?
  • Development of new features doesn't need to stop, it can continue alongside the refactoring or even get included into the refactoring process itself. Maybe changing the functionality first will make the later refactoring easier, or the refactoring can be targeted in a way to make the later change of functionality easier.

So, taking all that into account, who would ever consider a rewrite again? Now back to application I need to maintain, I'm sure it doesn't do much and I could easily replace it before I've even finished understanding what all that horrible, cluttered code in the original application actually does. I hear all the cool kids are playing with 'Rust' these days and it would be good to see what the Google Cloud platform is like for hosting…….


Popular posts from this blog

Mocking HttpCookieCollection in HttpRequestBase

When unit testing ASP.NET MVC2 projects the issue of injecting HttpContext is quickly encountered.  There seem to be many different ways / recommendations for mocking HttpContextBase to improve the testability of controllers and their actions.  My investigations into that will probably be a separate blog post in the near future but for now I want to cover something that had me stuck for longer than it probably should have.  That is how to mock non abstract/interfaced classes within HttpRequestBase and HttpResponseBase – namely the HttpCookieCollection class.   The code sample below illustrates how it can be used within a mocked instance of HttpRequestBase.  Cookies can be added / modified within the unit test code prior to being passed into the code being tested.   After it’s been called, using a combination of MOQ’s Verify and NUnit’s Assert it is possible to check how many times the collection is accessed (but you have to include the set up calls) and that the relevant cookies have …

Do "Task Hours" add anything in Scrum (Agile)?

What do task hours add to the overall process in scrum?This was a question that has arisen from all team members in both instances that I've helped teams switch over to scrum. The benefits of artifacts like the comparative story point estimation, the 2 week sprints, stand-ups and the end of sprint demo have been self evident to the team, but as one I think every team member has expressed dismay when it comes to task planning and estimating each task in hours. Left unchecked there is a natural tendency for people to actually begin to dread the start of each sprint purely due to the task planning session.In my current role we've been lucky to investigate this further as a team.The team sat down to discuss the problems it was experiencing with estimating tasks in hours and the following common themes appeared:It is hard: Maybe it shouldn't be, but time estimation is hard! Story points are comparative and abstracted making them easier to determine, but time estimate is gen…

Why do my Android Notification only appear in the status bar?

I'm definitely getting back into Android development, I'm remembering that feeling of 'Surely this should be easier than this!'. All I wanted to do was to schedule a local notification which behaved similar to a push notification pop-up. That is, as well as showing the small icon in the status bar I wanted it to pop up on screen to notify the end user. All seems fairly easily, I found this code for how to schedule a notification. That all worked perfectly, apart from the notification would only appear in the status bar. Searching around I found loads of different answers / solutions, mostly all saying the same thing:It only worked if you used 'NotificationCompat.Builder' in place of 'Notification.Builder', orYou had to set the priority to 'NotificationCompat.PRIORITY_HIGH'As usually happens, none of these solutions worked for me until I added in the missing piece of the jigsaw:- '.setDefaults(Notification.DEFAULT_ALL)'. For me this…