Episode 6: Before you clean up an inherited site, find out what it’s holding up
In this episode
Christopher inherited a website from a developer who ran it for eleven years and retired without leaving a note, and his first instinct was to quote a cleanup. Then he came within one keystroke of deleting the line that pays a sales team’s commissions. Frances makes him prove which broken-looking things the business is quietly standing on before he cuts a single one.
Takeaway: Somebody’s ugly workaround is somebody else’s payroll.
The artifact: The Inherited-Site Load-Bearing Map. You can grab it from the blog.
Full transcript: Episode 6
CHRISTOPHER: Last Tuesday I had my cursor sitting on a line of code that looked like pure garbage. An old email-to-fax gateway, a little job that took a custom order off the website and faxed it, an actual fax, to whatever machine used to sit on the workshop floor. Custom wood panels. Somebody orders one online, this thing faxes the cut sheet to the shop that builds it. A fax gateway, in this decade, that is the dictionary definition of dead junk. I had the whole line selected. My finger was on the key. And I stopped. I still can’t tell you exactly why I stopped. But I followed the thread, and here’s what I found. It stopped working. Sometime. And I cannot tell you when, could be last year, could be before anybody in that shop owned a smartphone. The fax on the other end went away, and this little job just kept quietly throwing orders into a hole. And nobody noticed. I came within one keystroke of deleting the only evidence that Wendell has been turning custom orders away for who knows how long. That’s the part that keeps me up. Not that I almost broke it. That it was already broken, and I almost erased the proof.
FRANCES: This is Sites I’ve Never Seen, the show where Christopher walks me through the work almost nobody gets to watch, the inherited messes, the code nobody signed their name to, the nights he spends alone inside a stranger’s decisions. I’m Frances. I run my own shop, I’ve never met a line item I didn’t interrogate, and my job here is to make him show his work before he charges a soul for it. Christopher, you want to send Wendell a quote for a cleanup. From where I’m sitting, you nearly sent him a bill for a demolition. Start me at the showroom.
CHRISTOPHER: Wendell runs a lighting showroom. His father opened it in the seventies; Wendell took it over. Chandeliers, track lighting, the little lamp on your grandmother’s hall table. Real floor, real customers, real business. And for eleven years, one developer ran the website. One person. Who retired this spring and left, no notes, no forwarding address, nothing but the logins he’d already handed over. So I open the hood, and it’s…
FRANCES: A haunted house.
CHRISTOPHER: Archaeology. Two page templates that look identical, doing almost the same job. A plugin I’ve never heard of, no author name, no readme, nothing. There’s one called, and I am not inventing this, “final-final-v2.” Activated. Load-bearing, for all I know.
FRANCES: Heh. That’s every folder on my desktop.
CHRISTOPHER: Right? And the house keeps going. A folder of images nobody’s linked to since, I actually checked, twenty-nineteen. A contact form that fires off to two addresses, and one of them bounces. Three different paths to the same product page, depending on which link somebody clicked years ago. Every room I open, the last guy left the light on and walked out.
FRANCES: And it’s all still running. Nobody’s touched it, nobody’s paid a soul to touch it, and it just… runs. Honestly, that’s the part that’d make me nervous.
CHRISTOPHER: So my first instinct, the honest one, the one I’m a little ashamed of now, was, I’ll quote him a cleanup. Two weeks. Strip it back to something clean, hand him a site I’d put my name on.
FRANCES: And what’s the cleanup worth?
CHRISTOPHER: I hadn’t gotten that far. In my head it was just clean work. Take out what doesn’t belong, keep what does.
FRANCES: See, that’s the sentence that gives me a stomachache. “Take out what doesn’t belong.” You’ve been in that building a week and you already know what belongs in a business you’ve never run.
CHRISTOPHER: That’s the tension, though. The mess genuinely slows everything down. Every future change eats more of my day because I have to understand two templates instead of one. So is the mess debt I strip out, or is it holding something up I can’t see?
FRANCES: Before you delete one line of it, that fax gateway. Who was on the other end, back when it still went through?
CHRISTOPHER: The workshop that cuts the panels. A custom order lands on the website, the gateway faxes the cut sheet, they build it. That was the whole loop. And I almost swept it out before I asked the question, I only found out it was dead because I stopped to look instead of deleting. The orders don’t land anywhere now. They just stop at a machine that isn’t there.
FRANCES: Right. And I’ve watched the version where nobody stops. I’ve got a client, a distributor, mid-sized, sells parts to trade shops. Couple years back they did a tidy little rebuild. New site, everything neat. And there was this nightly export nobody could explain. A file that got generated every night and, as far as anyone in the room could tell, went nowhere. Redundant. So it got cleaned up. Cut, in the name of tidy.
CHRISTOPHER: And it wasn’t redundant.
FRANCES: It was the office manager’s payroll input. Every night that file fed the commission numbers for the sales staff. And here’s what she’d actually been doing with it, all those years nobody thought to ask, every morning she’d open that file with her coffee, before the phones started, run her finger down each rep’s orders, and key the commission totals into payroll by hand. That was the whole job. Quiet, dead reliable, never once late. Nobody on the rebuild ever asked her, because she wasn’t in the meeting, you don’t invite the person whose work already works. Three people got paid wrong for a month before anyone traced it back to the thing we deleted for being untidy.
CHRISTOPHER: A month.
FRANCES: A month. And you want to know how they finally caught it? Nothing flagged, no system caught it, a rep opened his cheque, saw it was light, and made noise. Then somebody had to sit and work backward for two days: from a short cheque, to a missing file, to a line in a rebuild ticket that said, and I’m quoting, “removed redundant export.” Redundant. And the invoice for that isn’t the fix. The fix took an afternoon. The bill is three employees who found out their own company couldn’t get their pay right, and a payroll clerk who cried in the manager’s office. You don’t buy that back with an afternoon. Wendell doesn’t care what your code looks like, Chris. He’s never going to open it. He cares that the lighting keeps selling and his people get their cheques on Friday. Clean is your word. It was never his.
CHRISTOPHER: But let me push the other way, because the drag is real too. That duplicate template, the mystery plugin, they slow every single thing I touch from here on. Every change I make, I’m working around code I don’t…
FRANCES: understand, right. Which is exactly my point, from the other side.
CHRISTOPHER: It is my point, though. That drag doesn’t go away because we’re being careful about it. And let me make it real, because “drag” sounds like a feeling and it isn’t. Last week Wendell asked me for the smallest thing, move the phone number up on the contact page, above the fold. A ten-minute job. It ate most of an afternoon, because there are two templates that both look like the contact page, and I had to work out which one actually renders when a customer lands there. And the answer was: sometimes one, sometimes the other, depending on the link they followed. So I fixed it in the first template, tested it, and it was still wrong half the time. That duplicate isn’t a feeling. It’s a weight on every single thing Wendell asks me to change from here on.
FRANCES: Alright, I’ll take that seriously, because there’s a real cost sitting in there and it isn’t the afternoon. It’s this. A change that turns into that much of a fight is a change Wendell stops asking for. He wants the phone number moved, it becomes a whole ordeal, so the next time he’s got a small idea to make the place a little nicer for a customer, he just sits on it. Multiply that across a year, and the site quietly stops getting better. That’s a number too. It’s a slow one, the kind nobody ever writes on an invoice, but it’s real, and I’m not going to pretend you made it up.
CHRISTOPHER: Right, and it builds on itself. Every workaround I leave in makes the next change harder, and the one after that harder still. A year from now I’m three templates deep instead of two, and every small thing Wendell asks for is a bigger fight than the last one.
FRANCES: It’s real. And I’ll take that bet every day of the week. Because price the two mistakes against each other. Being wrong about the drag costs you, what, a few slower afternoons this quarter. Being wrong about one workaround costs a missed sale, or a wrong paycheque, or three people paid short for a month. One of those is an annoyance. The other one has a person’s name on it. Your slow afternoons never outrun the payroll.
CHRISTOPHER: So before I touch anything, and I catch myself doing this now, I’m asking your question. The day this line is gone, who’s the person who notices, and what are they holding in their hands when they do…
FRANCES: careful, Chris. You’ll put me out of a job. Now finish the sentence.
CHRISTOPHER: The day that fax gateway’s gone, the person who notices is, and this is the part that got me, nobody. Nobody notices. The person who should is a customer who ordered a custom panel and never heard back. What that costs Wendell past that, no, let me back up, “costs” isn’t even my word. I can find the wire. I can’t read the number on the end of it. That part’s still yours.
FRANCES: It’s every custom order that quietly walked. And you’ll never get a bill for those, because they never became invoices, the customer just called whoever came up next and you never knew they were there. That’s the worst kind, Chris. It doesn’t show up as a number. It shows up as a number that was never there. And I’ll say the quiet part, two months ago I was the one telling you a Saturday could wait, and you fought me down to the studs. Now you’re running the count before I can get my mouth open. Doesn’t mean you’re right about the cleanup yet. Just means you finally learned to stall.
CHRISTOPHER: And I want to say something about the person who built all of this, because it would be easy to make him the villain. He isn’t. Every weird thing in there was a decision that made sense to somebody under a constraint I can’t see anymore. The duplicate template, I’ll bet there was a reason once. I just don’t have the reason yet.
FRANCES: The fax gateway’s the proof of that. Think about when he built it. The shop floor had one machine that took orders and it went beep. No budget to put a computer next to the saw, no clean way to get a web order into a fabricator’s hands. So he bridges it, the website drops the order onto their fax, and it shows up right where the work happens. That’s not garbage. That’s the cleverest thing going, for its day. He…
CHRISTOPHER: and it worked. For years, it just worked. That’s the part that guts me. It ran right up until it didn’t, and by the time it went quiet he was long gone, and there was nobody left who even knew to check.
FRANCES: Built to run without him. That’s the whole job. The fact that it eventually went dark isn’t on him, he’d been gone for years. I’d still have hired him.
CHRISTOPHER: I keep coming back to the fact that I almost didn’t stop.
FRANCES: But you did. And for what it’s worth, I don’t hand these out, most people don’t stop. They’re already congratulating themselves on the tidy before they’ve asked who’s living in the house. You stopped with your finger on the key. That’s the whole job, Chris. That’s not nothing.
CHRISTOPHER: So what do you do with a whole site full of things you can’t explain yet?
FRANCES: You stop calling it a website. That’s the mistake baked right into the word “cleanup”, it treats the thing as code. It isn’t code. You didn’t inherit a website, Chris. You inherited every promise other people are quietly relying on that site to keep. The commission run. The order that still comes in through a link somebody bookmarked in 2019. The report that lands on a desk every Monday morning. You bought all of it the day you took the login.
FRANCES: Somebody’s ugly workaround is somebody else’s payroll.
CHRISTOPHER: Say that again.
FRANCES: Somebody’s ugly workaround is somebody else’s payroll. The ugliness is yours to look at. The payroll belongs to a person who never sees the code and cannot afford for you to be wrong about it.
CHRISTOPHER: So here’s what I actually did at Wendell’s, instead of the quote. I built a map. One page. Every weird thing gets a row, the fax gateway, the duplicate template, the plugin with no name. And next to each one I finish a sentence I can’t fake: the day this is gone, the person who notices is blank, and they notice when blank. If I can fill both blanks, I know what I’m holding. If I can’t, I don’t cut. I go find out first.
FRANCES: Walk me through one. Because from here it sounds like a worksheet, and I don’t buy a worksheet.
CHRISTOPHER: Fair. Take the duplicate template, the one that cost me the afternoon. On the map it starts as a blank: the day this is gone, who notices, and when. And I could not answer it from the code. Two templates, near-identical, side by side, and reading them told me nothing. They both looked deletable.
FRANCES: So how’d you fill it?
CHRISTOPHER: Three ways, none of them clever. First I asked, Wendell, his counter staff, whoever picks up the phone: who actually uses the contact page? And I got shrugs, because nobody thinks about the page that works. Which felt like nothing, but it was worth knowing, it meant nobody would notice on the day I broke it. That’s the trap, right there. Then I watched the logs. The real server records of which template renders when a live person loads that page. And for weeks it was the same one. Every single time, the same template. I very nearly cut the other one on the spot.
FRANCES: But.
CHRISTOPHER: But I looked at when the log went quiet, and I waited. And the one stretch that second template woke up was the week of Wendell’s spring lighting sale. There’s a seasonal promotion page, the big banner, the discount event he runs twice a year, and it renders through the second template. Only the second one. So eleven months out of twelve it looks like dead weight, and then twice a year it’s the page his entire sale runs through.
FRANCES: So that row didn’t land in “cut.”
CHRISTOPHER: That row landed in “keep.” With a note: don’t touch this until you’ve watched a full year go by. If I’d trusted the first look, the side-by-side, the quiet log, I’d have deleted it in week one and been very proud of the tidy.
FRANCES: And found out in the spring. From Wendell. On the one week his sale carries the quarter. That’s the version where your cleanup cuts his best week off at the knees.
CHRISTOPHER: That’s the version. That’s the whole reason the row exists.
FRANCES: And how many rows could you not fill in?
CHRISTOPHER: Out of maybe fourteen? Six. Six things I could not tell you what they were load-bearing for. Which two months ago I’d have called garbage and swept out on day one.
FRANCES: Okay. Now I’m going to concede something, and I want you to notice I’m not conceding the instinct. Because the same eye that wanted to bulldoze the place is the eye that found the one thing that actually did have to go that day. Tell them what the coupon was.
CHRISTOPHER: There was an old discount code. A test coupon from years back, never taken down, still live. Long forgotten. But any order that came in through one particular old link, an email from years ago, a page still sitting in somebody’s cache, it silently applied. Fifteen percent off. No questions asked.
FRANCES: Fifteen percent. Off real orders. Quietly. Call it a few hundred dollars a month walking straight out the door, every month, for who knows how long. And here’s my confession: I’d have left it. It’s live, it’s working, don’t touch it, that’s my whole religion. You’d have flagged it and I’d have told you to put it down. So I’m not conceding my instinct. Leave the working thing alone is still right most days. What I’m conceding is the order. Map first, then cut. But the cutting eye, the one that spots a live coupon bleeding margin while everybody else is admiring the tidy, that’s the thing that never fits in a row. That’s why you pay a person and not a worksheet.
CHRISTOPHER: And that’s the part the map can’t do. The map lists the weird things I can see. It can’t tell me which blank I filled in is a lie. That the fax gateway’s been dead for years and nobody saw, that the coupon’s live and lying, reading the invisible wire between a line of code and a person’s Friday, the map doesn’t do that. That’s the part I didn’t understand walking in.
CHRISTOPHER: And underneath all of it is the part I actually got wrong. I’d been reading all that mess as disrespect. For the craft. Like the site was a junk drawer somebody dumped on me and my job was to be offended by it and empty it out. It’s not a junk drawer. Every ugly line in there is a decision somebody made on a real day, for a real reason, to keep a real promise. The site wasn’t a dumpster. It was a diary. And you don’t strip a diary for parts, you read it first.
FRANCES: And here’s what it was worth, in my language. Walking in, Wendell had two options and both of them were expensive. “Touch nothing”, and keep bleeding fifteen percent off every stray order, forever. Or “replace everything”, and pay to break the six things quietly holding his business up. Both of those are bills with no ceiling on them. What the map did, the boring, one-page map, is turn both of those into a list with prices next to it. This row we cut Tuesday. This row we leave alone. This row we go ask the office manager about before anybody breathes on it. That’s not craft to me, Chris. That’s the most expensive decision Wendell owns, turned into a number he can actually read.
CHRISTOPHER: I keep thinking about that fax gateway. Somebody built it years ago to solve one small problem, get a custom order off a website and onto a workshop floor, and it did that quietly for a long time, and then it died just as quietly, and nobody was watching the day it went. It looked like garbage to me. I almost erased the only proof it ever mattered. I know every one of you has one of these. Some ugly, undocumented thing, and you cannot tell from the outside whether it’s holding the floor up or whether the floor already fell through. Send me the weirdest one you’ve found, the thing that looked like junk and turned out to be load-bearing, or the thing everyone tiptoed around that had quietly stopped working years ago. I collect them now. This is Sites I’ve Never Seen. Glad you were here.