Settings

Theme

Ask HN: Good resources to learn how to write well?

4 points by Dansvidania 16 hours ago · 3 comments · 1 min read


I am mainly interested in technical writing: essays, blog posts, news articles, perhaps RFCs ?

In order of preference, i'd say I'd love a book, course, article.

Thanks in advance!

cyndunlop 2 hours ago

I'm biased (as a co-author), but I recommend Writing for Developers, published by Manning. ;-) https://github.com/scynthiadunlop/WritingForDevelopersBook

Feel free to find and DM me if you want a preview. Also, there are lots of tips from other tech bloggers here https://writethatblog.substack.com/t/tech-blogger-insights

treetalker 15 hours ago

- Minto's Pyramid Principle (writing as structure; state your point and then unfold more and more details as you go)

- Clear and Simple as the Truth (writing in the "classic style")

- There is no dearth of books about writing, with many recommendation threads on HN already.

- Research the mental model of the "rhetorical move". You will find that there are several books on using patterns in writing. Many are written for non-native speakers of English engaging in academic writing. But the idea is very useful for all genres!

---

You didn't ask for them, but here are some favorite tips:

Think about your writing structurally / architecturally. Be mindful of patterns. Strive for clarity and concision. Know and consider your audience.

Read. Question what you read. What qualities does the writing have? Why? What structures and patterns does the writing have? What are the functions of the parts and the whole? Why and how do the patterns and functions work well?

Question your own drafts. What qualities do you want your writing to have? Why? What is the essence of those qualities? Have you achieved them? Can you design exercises for yourself to develop those qualities?

Write every day. Engage in deliberate practice of certain aspects of writing.

Write and revise several drafts. Let drafts incubate.

Try writing by hand. Try writing on notecards and rearranging them in piles or on your physical desktop. Try dictating and transcribing. Try typing each sentence on its own line (it makes rearrangement easier by moving lines up or down with keyboard shortcuts in a text editor like Sublime Text). Try thinking through and mindmapping your structure before writing the draft. Try drafting in a good outliner, such as Bike or OmniOutliner.

Develop and maintain a professional relationship with a good human editor.

bigbuppo 16 hours ago

For starters, I would say Enterprise Content Strategy: A Project Guide is a good choice. Though really, the important take away is to know your target audience. There are a few other gems over on xmlpress.net that are also worth a look.

Next, read the sort of things you want to write, then try writing the things you want to write. It's really that simple!

Keyboard Shortcuts

j
Next item
k
Previous item
o / Enter
Open selected item
?
Show this help
Esc
Close modal / clear selection