This article explores what makes a great project README, how Appsmith made ours as accessible as possible and provides examples of other effective READMEs.
Two universal facts about user documentation:
Documentation is really important. We are really bad at writing it. We don’t have good theories on what makes for useful documentation. That is except for the four document model, or Diátaxis.1 I’m glad that people use it. I’m also a little frustrated that people use it even when its inappropriate. My problem is that it’s not a universal or comprehensive model: there’s a lot of documentation people need to write that doesn’t neatly fit the model.
Boustrophedon is a style of writing in which alternate lines of writing are reversed, with letters also written in reverse, mirror-style. This is in contrast to modern European languages, where lines always begin on the same side, usually the left.
The following first appeared in Lit Hub’s The Craft of Writing newsletter—sign up here. Here, in short, is what I want to tell you. Know what each sentence says, What it doesn’t say, And what…
Readability: The Optimal Line Length – Articles – Baymard Institute
The length of text lines substantially impacts their readability — yet this is often overlooked in e-commerce. See our latest test findings on line length readability.