# Writing well

- Page: https://shared.btbytes.com/p/writing-well
- Date: 2025-08-03

Writing well comes to down to holding the reader's attention.

- Make sentences flow from one to another, make sure the reader is [never surprised](https://grantslatton.com/how-to-design-document), anticipate objections
- Edit, and edit again. Remove all fluff. Use [short sentences](https://www.btbytes.com/book/Several-Short-Sentences-About-Writing). Read your own writing with a "red pen"
- Delete anything that makes you pause and go back and look around for clues.
- Practice #writing. Make your own opportunities to write by [putting your name on it](https://simonwillison.net/2025/Jul/16/documenting/)... "You can have an unreasonable amount of influence by being the person who _writes stuff down_".
- Writing well starts with writing stuff down.


----


Couple of points from CS Lewis advice on writing, I liked:

1. Write with the ear, not the eye
2. Write what interests you
3. Don't use words (or phrases, or sentences, or paragraphs) you don't understand -- say no to Copy-Pasting.

<figure>
  <img src="https://files.btbytes.com/screenshots/2025/writing-cslewis.jpg" alt="C S Lewis on writing (1959)" width="600px">
  <figcaption>C S Lewis on writing (1959)</figcaption>
</figure>
