← All writing
Careers · 5 min read · 13 Aug 2026

Building a Case Study a Hiring Manager Will Actually Read

Most portfolio write-ups get skimmed for ten seconds and closed. Here is how to structure one that survives past the first paragraph.

Cover image for the article: Building a Case Study a Hiring Manager Will Actually Read

Why most case studies fail before the second paragraph

A hiring manager reviewing candidates for a machine learning role typically has a stack of tabs open and a short window to decide whether yours is worth a proper read. They are not looking for a tutorial on gradient boosting or a restatement of what a confusion matrix is. They are looking for evidence that you can frame a problem correctly, make defensible choices under constraints, and be honest about where the work falls short. Most portfolio write-ups fail this test in the first paragraph because they open with the dataset and the model architecture, which is the least interesting part of the story to someone who has seen a hundred variations of the same random forest on the same tabular dataset.

The fix is not more polish. It is a different structure, one that mirrors how a competent practitioner actually reasons about a problem, not how a report is conventionally organised. If you lead with the business or research question, state the constraint that made the problem hard, and only then move into the technical detail, you signal something more valuable than skill with a library: judgement. Judgement is what gets people hired, because models can be learned on the job but judgement is expensive to teach.

Structure that rewards a fast reader

Write the case study so that someone who reads only the first sentence of every section still comes away with the full argument. Start with a single sentence stating the problem and the decision it was meant to inform, for example: 'this project predicts customer churn thirty days in advance so that a retention team can prioritise a limited outreach budget.' That sentence does more work than a paragraph of background, because it tells the reader the stakes and the constraint in one breath.

Follow with a short section on why the naive approach would have failed or misled. Say you found that a simple accuracy metric on the churn model looked excellent, around ninety-four per cent, but the dataset was heavily imbalanced with churners making up roughly six per cent of customers, so a model that predicted 'stays' for everyone would have scored close to that same number. Naming this trap and showing that you caught it is worth more to a hiring manager than any leaderboard score, because it proves you know that a metric divorced from context is worthless.

Then walk through the evaluation design specifically, because this is where most candidates lose credibility without realising it. If your churn labels were generated using a rolling window, did you split your train and test sets by time rather than by random shuffling? A random split lets information about the future leak backwards into training, quietly inflating every number that follows. If you split by customer instead of by time and your dataset has repeated observations per customer, the same leakage risk appears in a different disguise. Stating plainly which splitting strategy you used and why is a small paragraph that does an outsized amount of trust-building.

person writing notes at laptop

A worked example of the honest middle section

Suppose your churn model, after a leakage-aware time-based split, achieved a precision of forty-one per cent and a recall of sixty-eight per cent at the top decile of predicted risk, compared with a baseline logistic regression using only tenure and last-login-date that achieved thirty-two per cent precision and fifty-nine per cent recall at the same decile. Reporting both numbers, rather than only your final model's score, does two things. It gives the reader a reference point to judge whether the added complexity of your chosen model was worth it, and it shows you built a baseline deliberately rather than jumping straight to something more sophisticated because it felt more impressive to write about.

Now explain the trade-off in terms that connect to the original decision. If the retention team can only act on the top decile because of budget, then the nine-point improvement in precision translates into roughly nine fewer wasted outreach calls per hundred contacted, which is a concrete number a non-technical reader can weigh against the cost of maintaining a more complex model. This is the paragraph that separates a case study from a lab report: it closes the loop back to the business question stated in the opening sentence.

Finally, include a short and genuinely candid limitations section. Perhaps the model's performance degraded for customers who joined in the last three months because there was too little history to build reliable features, or perhaps the time-based split meant your test period included an unusual promotional event that may not generalise. Naming these limitations without being asked is a stronger signal of seniority than a polished summary that pretends the work was flawless, because every experienced reviewer knows real projects have rough edges, and pretending otherwise reads as either inexperience or dishonesty.

The practical takeaway

If you only change one thing about how you write case studies, change the opening. Replace the dataset description with a single sentence naming the decision the work was meant to support, followed immediately by the constraint or trap that made the naive approach insufficient. Everything else, the baseline comparison, the leakage-aware split, the honest limitations, exists to support that opening sentence rather than to showcase technique for its own sake.

Keep the write-up short enough that a hiring manager can read it in the time they actually have, which is closer to two minutes than twenty. A tight page that demonstrates judgement will beat a long one that demonstrates only effort, and it will do so every time it is read against someone else's polished but hollow account of the same kind of project.

whiteboard with data charts
← All writing See the project case studies →