Rewrite (programming)

A rewrite in computer programming is the act or result of re-implementing a large portion of existing functionality without re-use of its source code. When the rewrite is not using existing code at all, it is common to speak of a rewrite from scratch.

Motivations

A piece of software is typically rewritten when one or more of the following apply:

its source code is not available or is only available under an incompatible license
its code cannot be adapted to a new target platform
its existing code has become too difficult to handle and extend
the task of debugging it seems too complicated
the programmer finds it difficult to understand its source code
developers learn new techniques or wish to do a big feature overhaul which requires much change
developers learn that new codes written may extend content options that can fix or overwrite previous problems
the programming language of the source code has to be changed

Risks

Several software engineers, such as Joel Spolsky^[1] have warned against total rewrites, especially under schedule constraints or competitive pressures. While developers may initially welcome the chance to correct historical design mistakes, a rewrite also discards those parts of the design that work as required. A rewrite commits the development team to deliver not just new features, but all those that exist in the previous code, while potentially introducing new bugs or regressions of previously fixed bugs.^[2]^[3] A rewrite also interferes with the tracking of unfixed bugs in the old version.^[4]

The incremental rewrite is an alternative approach, in which developers gradually replace the existing code with calls into a new implementation, expanding that implementation until it fully replaces the old one. This approach avoids a broad loss of functionality during the rewrite. Cleanroom software engineering is another approach, which requires the team to work from an exhaustive written specification of the software's functionality, without access to its code.^[5]

Notable examples

Netscape's project to improve HTML layout in Navigator 4 has been cited as an example of a failed rewrite. The new layout engine (Gecko) had developed independently from Navigator and did not integrate readily with Navigator's code; hence Navigator itself was rewritten around the new engine, breaking many existing features and delaying release by several months. Meanwhile, Microsoft focused on incremental improvements to Internet Explorer and did not face the same obstacles.^[3]^[6] Ironically, Navigator itself was a successful cleanroom rewrite of NCSA Mosaic overseen by that program's developers. See Browser wars.

References

^ Spolsky, Joel. "Things You Should Never Do, Part I". Joel on Software. Retrieved 2015-01-23.
^ Ronkes Agerbeek, Joost (April 15, 2005). "Never Rewrite Code From Scratch". Archived from the original on October 10, 2008. Retrieved 2008-09-11.
^ ^a ^b Spolsky, Joel (April 6, 2000). "Things You Should Never Do". Retrieved 2008-09-11.
^ Zawinski, Jamie. "Cascade of Attention-Deficit Teenagers". Retrieved 2008-09-11.
^ Tilly, Ben (September 29, 2001). "Rewriting, from scratch, a huge code base". Retrieved 2008-09-11.
^ Zawinski, Jamie (March 31, 1999). "resignation and postmortem". Retrieved 2008-09-11.

External links

RewriteCodeFromScratch at C2 Wiki
Things You Should Never Do, Part I by Joel Spolsky

[1] Spolsky, Joel. "Things You Should Never Do, Part I". Joel on Software. Retrieved 2015-01-23.

[2] Ronkes Agerbeek, Joost (April 15, 2005). "Never Rewrite Code From Scratch". Archived from the original on October 10, 2008. Retrieved 2008-09-11.

[spolsky-3] Spolsky, Joel (April 6, 2000). "Things You Should Never Do". Retrieved 2008-09-11.

[4] Zawinski, Jamie. "Cascade of Attention-Deficit Teenagers". Retrieved 2008-09-11.

[5] Tilly, Ben (September 29, 2001). "Rewriting, from scratch, a huge code base". Retrieved 2008-09-11.

[6] Zawinski, Jamie (March 31, 1999). "resignation and postmortem". Retrieved 2008-09-11.

[1]

[2]

[3]

[4]

[5]

[6]

Contents