3 ms·
The tips at the end of the article are pretty solid. I'll add some more that helped my writing immensely: * Use bold text once or twice per section to break up
by verdagon 4y ago
The tips at the end of the article are pretty solid. I'll add some more that helped my writing immensely:
* Use bold text once or twice per section to break up the monotony and draw the reader's eye to where you want it.
* Shorten! Cut away anything optional to the reader understanding your main point, and move it to footnotes, sidenotes, or a linked document/page.
* Have someone read your first draft. If they ask a question, don't answer it directly! Update your draft instead.
* Use lists religiously! Walls of text tend to repel attention.
My favorite article [0] happened to use all these tips, if anyone wants to see an example. Happy writing!
[0] https://verdagon.dev/blog/higher-raii-7drl https://verdagon.dev/blog/higher-raii-7drl
- drewcoo 4y ago> Use bold text Really? Why not just . . . > Shorten And as an atheist, I can't stress the next one enough. Listicles are not ideacles, or somesuchacle. Lists show a lack of pedagogical thought. > Use lists religiously!
- Ygg2 4y ago> Really? Why not just . . . > > Shorten By being too terse you risk avoiding some important aspect for documentation, preventing someone from understanding it. It's a balancing act.
- dtgriscom 4y agoYou're being cute, but losing meaning. Do you support using lists, or do you object to them?
- jakub_g 4y agoAbout shortening: highly recommend glancing over "On Writing Well" by Zinsser. If you only have 30s, just look at this page from this book: https://scholarsandrogues.files.wordpress.com/2015/05/zinsser-book.jpeg https://scholarsandrogues.files.wordpress.com/2015/05/zinsse...
- baby 4y agoStephen King has a similar few pages in his book On Writing. I really really love the short sentences + short paragraph style. One of the author that excels at that is Bukowski.