2026-05-20

Start cards should name the route

A homepage card works better when it says whether it routes to proof, context, or published work before the reader has to infer the click.

I like short homepage card rows, but they only stay useful if each card makes its job obvious quickly. The problem is not usually that a site has too many links. The problem is that the reader has to infer why one link exists and how it differs from the card next to it.

If the first card is a repo proof, the second is a case study, and the third is an external article, those are three different jobs. When the labels are vague, the reader has to do extra work just to figure out whether a click will give them evidence, explanation, or broader context.

The route label is part of the interface

I increasingly want small public surfaces to say the route directly. That usually means a card should name one of three jobs:

  • proof
  • context
  • published work

Those labels are not complicated, but they reduce the amount of interpretation required before the first click. They also make it easier to trust the rest of the surface, because the cards stop feeling like a miscellaneous set of recommendations.

This matters even more for repo tracks

I already want each repo track to start with one proof and one context link. But if the proof and context roles only live in the paragraph copy, the surface is still doing too much hiding. The better version is to make the pair visible in the card labels and the short setup text around them.

That way the reader can tell the difference between:

  • the repo that proves the batch
  • the note that explains the standard behind the batch

That is a better first move than pushing people into a full repo inventory and hoping the meaning shows up later.

The goal is not more chrome

I do not want every card to become a taxonomy exercise. I only want the first few cards on a surface to state enough about the route that the user knows why the link is here. Once that is clear, the rest of the page can stay quiet.

The point is simple: a start card should not only look curated. It should also tell you what kind of next move it is.