---
title: Laymen want documentation they understand
date: "2002-09-04T12:00:00Z"
categories:
  - links
wp_id: 1185
description: I wish I had realized sooner that programmers must write documentation laymen can actually understand. It is a vital lesson for developers to prioritize clarity and accessibility over technical jargon for non-expert users.
keywords: [documentation, technical writing, software development, user experience, clarity, accessibility]
---

Programmers: learn from this. [Laymen want documentation they understand](http://advogato.org/article/374.html). (Wish someone told me 5 years ago.)