Your Portfolio Has a Reading Problem
Portfolio / Career

Your Portfolio Has a Reading Problem

Meet Dani. Dani spent six weekends on a churn analysis: 41 notebook cells, a cleaning step that would make a tax inspector weep with joy, a model, and one genuinely useful finding at the end. Dani linked it in thirty applications.

Thirty applications later, Dani had heard nothing. Silence isn’t feedback. It just feels like it.

(Dani is a composite: a few portfolios we’ve reviewed, blended so nobody gets recognised at a family dinner. You may still recognise Dani in the mirror. We did.)

What was wrong with the project?

That’s the question Dani kept asking, and it’s the wrong one. The analysis was sound. The code ran. The finding was real. If you had sat Dani down and asked for a walkthrough, you’d have been impressed by minute four.

Nobody sat Dani down. That’s the part portfolio advice tends to skip: a portfolio isn’t marked like an exam. Nobody is obliged to finish it. It’s read like a shop window, by someone with a full inbox, a coffee going cold and a stack of other windows to look into.

You’ve probably heard the folklore that recruiters spend six seconds on a CV. The exact number is disputed, and we’re not going to pretend we know it. The behaviour is easier to believe, because you do it too: skim the top, then decide whether to keep going.

Here’s the test we ran on Dani’s project

Open it like a stranger would. No context, no scrolling yet. What’s on the first screen?

A title: churn_analysis_final_v3. Eleven import lines. A CSV being loaded. A df.head() showing five rows of customer IDs. Which raises the uncomfortable question: if that was all you saw, what would you think this person can do?

“Import pandas,” mostly.

So where was the good bit? We kept scrolling. Past the cleaning. Past the exploration. Past three charts with default titles and one with no title at all. And then, finally, there it was: the sentence that belonged on the first screen.

Cell 37.

Illustration: attention is strongest on the first screen of a project and fades with every cell; the answer sits far below, at cell 37.firstscreenmanystopherecell 37 · the answer↓ eight screens down
Fig. 1 — An illustration, not a measurement: attention is spent at the top and fades fast. Dani’s answer was eight screens down.

The work wasn’t bad. It was buried. It had something worth saying and had put it where nobody would hear it, after thirty-six cells of throat-clearing.

Flip it

The fix isn’t more work. It’s the same work in a different order. We build analysis from the bottom up: imports, data, cleaning, exploring, answer. People read it from the top down. So lead with the thing they came for, and let the method follow for anyone who wants it.

Before: imports, loading, cleaning, exploring, modelling, then the answer last. After: the answer first, then the chart, then how it was done.How we build it1. Imports2. Load the CSV3. Clean4. Explore5. Model6. The answerHow they read it1. The answer2. One chart3. Why it matters4. How: data5. How: method6. How: code
Fig. 2 — Same project, two orders. Keep the build order in your notebook; give readers the reading order.

Now, what this doesn’t mean. It doesn’t mean hiding the code. The people who hire analysts do care how you got there. They just won’t find out unless the first screen gives them a reason to.

The three lines that do the heavy lifting

Here’s the change we’d make first, because it’s the smallest: put three lines at the top of every project, before a single import.

An example README in three lines: the question, the answer, and so what, followed by one chart.EXAMPLETHE QUESTIONWhich new customers leave in their first 90 days?THE ANSWERThe ones who never open a second report:they leave at about twice the rate.SO WHATA day-7 nudge to build report two is the cheapest test.+ one chart. Everything else goes below.
Fig. 3 — An example three-line README: the question, the answer, and so what. Then one chart. Everything else goes below.
Your first screen, in order
  1. The question, in plain words. Not “EDA on telecom data”.
  2. The answer, with the number in it.
  3. So what: the decision someone could make because of it.
  4. One chart that proves the answer, with a title that says the answer too.
  5. A real name. final_v3 is a confession, not a title.

On LucidPlexus, this is exactly what the snap button on a guided-project workbench cell is for. Snap the cell that holds the answer, the table or the chart, and post that, rather than the thirty-six cells that got you there. Then link the full project underneath for the people who want the whole walk.

As for Dani: same analysis, three new lines at the top, one chart moved up, a title a human could say out loud. Nothing else changed. Whether that’s enough is the next thirty applications’ job to tell us.

One question before you open your own portfolio

If someone read only the first screen of your best project, and nothing else, what would they think you do for a living?

And would they be right?

References

On LucidPlexus
Elsewhere

Comments

No comments yet. Be the first to share your thoughts.