Refactor Me

The instructions for using this WikiTag vary depending on whom you ask.

In favor of the badge:

Against the badge:

Just a note: We use OpenWiki internally for system documentation and I have established RefactorThis as a WikiBadge. The reason is I am running across a bunch of code in our system that needs to be refactored, but I may not have the time to refactor it right then, so I slap in this WikiBadge and come back to it later. For example, I just ran across an ASP class called HtmlUtils? that has no real use in our site. No callers reference it so I could just delete it, but I've looked at it twice and have the feeling I can perhaps salvage a few things from it (rather than re-write them later) but I don't have the time right now, so for the HtmlUtilsClass? entry I slap in a RefactorThis badge. Then I can come back later and look at the RefactorThis page and find all the entries that need refactoring. I am establishing the convention that an entry which uses this badge should at least make a note of what needs to be refactored, either the item discussed or the entry itself. We'll see how it works out. --DaveCantrell

Looking through the backlinks of this page, you can see a lot of pages that seem to link here because they're discussing the concept of RefactorMe rather than because they need to be refactored. Just an observation...

Valuable pages that merit a RefactorMe exercise

I have seen pages with valuable contributions (more so than the average) from many parties that can benefit from refactoring. However the person who recognise this need may not be suited for the task, due to lack of experience, expertise, etc.

a second obstacle is that not many of us can refactor a busy but valuable page quickly. It may even take more than one person to collaborate on the refactoring effort. And during that refactoring process the page content becomes unstable, and could even have "step backward" moments.

A third difficulty lies in the extra effort required in attempts to MakeRoomForAllViewpoints, or most of the viewpoints. And to make the call to exclude contributions with "marginal" value.

These are some of the pages I wish someone would come in and start refactoring:


EditText of this page (last edited January 17, 2005) or FindPage with title or text search