writing-diary-phrase

81 bookmarks
Newest
How to Write a Great README
How to Write a Great README
This article explores what makes a great project README, how Appsmith made ours as accessible as possible and provides examples of other effective READMEs.
·appsmith.com·
How to Write a Great README
My Problem With the Four-Document Model
My Problem With the Four-Document Model
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.
·hillelwayne.com·
My Problem With the Four-Document Model
Boustrophedon - Wikipedia
Boustrophedon - Wikipedia
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.
·en.wikipedia.org·
Boustrophedon - Wikipedia
Jim Lehrer’s Rules of Journalism
Jim Lehrer’s Rules of Journalism
The long-time host of PBS NewsHour Jim Lehrer died this week at the age of 85. In this age of news as entertainment and opinion as
·kottke.org·
Jim Lehrer’s Rules of Journalism
Verlyn Klinkenborg on Writing More Clearly
Verlyn Klinkenborg on Writing More Clearly
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…
·lithub.com·
Verlyn Klinkenborg on Writing More Clearly