Knowledge Base · Infrastructure & deployment
Turning a product list into navigation: eleven entries, two links each
The symptom
The catalogue was a place where descriptions went to die. Visitors could not see the breadth of what exists, and one link pointed at a retired address.
What was actually wrong
The list mixed two different things: what a project is (which the page around it already explained) and where to go next (which only the entry itself knows). Descriptions therefore duplicated the surrounding copy while the actionable part stayed hidden.
The fix
Each entry became a compact card with a name and two pill links — a live product and its repository — in a scrollable grid capped at most of the viewport height, and the one stale address was corrected to the product's current home.
What we took away
Lists are navigation, not prose: name plus destinations. Keeping one pattern per entry means adding the twelfth item costs no thought, and a stale link is visible because it breaks the pattern rather than hiding inside a paragraph.