writing-diary-phrase

Basic rules for building effective websites

null

null

null

Writing is a way of learning. And we can save what matters about it if we’re willing to learn something ourselves.

This article explores what makes a great project README, how Appsmith made ours as accessible as possible and provides examples of other effective READMEs.

On writing, reflection, and optimization

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.

Even without knowing the aphorism definition, you may already use it. Knowing the aphorism meaning helps make it more effective.

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

:love_letter: Things I've learned about writing good READMEs. - hackergrrl/art-of-readme: Things I've learned about writing good READMEs.

Too much introspection? Introspec-ception?

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…

An awesome README template for your projects! Contribute to Louis3797/awesome-readme-template development by creating an account on GitHub.

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.

A history of our metaphorical understanding of the web