← The Journey

Sharper Words, Smaller Cards: A Copy Pass on the Portfolio

Projects 2026-06-13 · Saturday · 2:35 AM 4 min read 90% AI Eric Li

The site shipped yesterday, but the words on it were the part I'd rushed. Today was about going back over the copy with the same care the design got, simplifying the project cards, and fixing a couple of buttons that looked clickable but did nothing. None of it is live yet — it's all sitting on the local server on port 3002 for me to review before any of it touches the real domain.

The Copy Was Failing My Own Rules

The clearest problem was the About paragraph. It opened with "a passionate full-stack developer and network enthusiast with deep expertise in infrastructure, automation, and building scalable solutions." Every one of those phrases is on my own banned list — the vague, inflated language that says nothing a hiring manager can check. I'd written a rule against exactly this and then walked straight into it.

Before rewriting anything I had a research agent go and read the best IT, infrastructure, and SRE portfolios it could find and pull out what actually works: lead with what you build, replace adjectives with artifacts, replace claims with numbers, and never use a sentence that would fit on anyone else's site. It came back with a tight playbook, and the throughline matched my writing rules almost word for word.

Writing It for an Employer, Keeping It True

The rewrite rule I held to was simple: sharper, but never inventing anything I can't back up. No fake uptime figures, no metrics I don't have. The About now leads with the real homelab — five isolated VLANs, twenty-odd containers, monitoring running around the clock, all built from scratch — and ends on the honest version of where I am: moving into tech by 2027, and happier to prove it with systems that run than with a title I don't hold yet. The stat captions lost their "innovative solutions crafted" padding. The portfolio heading went from "building solutions that matter" to "work that ships and runs."

The contact section did the most useful single change. It used to be a fragment of buzzwords; now it says plainly that I'm open to roles and projects in networking, infrastructure, and full-stack work, and that I usually reply within a day. That one line does more for a recruiter than the rest of the page combined.

I also stopped pretending to be only one thing. The site branded me "Full Stack Developer," but the strongest evidence on it is all infrastructure. I settled on a hybrid — "Full-Stack & Infrastructure" — across the title, the hero, and the footer, so the dev projects and the network direction both stay in view.

The Buttons That Did Nothing

Under the portfolio heading sat three pills — Completed, In Progress, Upcoming — that looked like controls but were inert text. They now jump to the matching group further down the page, landing cleanly below the floating nav. And the hero had a "Lab" button next to "Projects" that I never liked; it's gone for now, and I'll decide what belongs there later.

Shrinking the Cards

The project cards were doing too much. Each one dumped a paragraph, a full spec breakdown, and a row of tags all at once, so the section was a wall of text. The fix was to collapse it: every card now shows just a title, one sentence, and a small "Details" button. Press it and the tags and the full breakdown unfold underneath. It's built on the browser's own expandable element, so it works with a keyboard and needs no JavaScript.

Getting the button to look right took a few passes, and most of the trouble was a detail I should have known. The browser draws its own triangle marker on these expandable elements, and my first attempt only blanked it instead of removing it, so a stray arrow kept sitting off to the left. Once that was properly gone the button centred itself, and I shrank it down to a small pill with the text in the same purple the rest of the site uses, a little arrow underneath pointing down that flips up when the card opens. Small thing, but it's the difference between looking deliberate and looking unfinished.

What's Next

  • Review the whole copy pass and the new cards on the local server before deciding to push
  • Decide whether the portfolio subpages should get the same simplified cards or stay as the detailed view
  • Work out what replaces the removed "Lab" button in the hero
  • Push to n5hq.me once I'm happy with it

The lesson is one I keep relearning: it's easy to get the design polished and leave the words as an afterthought, but on a portfolio the words are doing the actual selling. A rule is only worth something if you check your own work against it, and I'd shipped a paragraph that broke mine. Fixing it cost an afternoon. Leaving it would have cost the first impression.