Ask HN: Good resources on learning how to write

#1

Post by jayfk » Mon, Oct 19, 2020, 12:14 AM UTC

Are there any good resources available to write high quality technical content (tutorials/how tos/blog posts)?

I wrote a couple of pieces here and there but I always had the feeling of getting stuck in the middle of the article, making it a tough grind to actually finish it.

How have you learned to produce good educational content? Are there any good resources available?

Re: Ask HN: Good resources on learning how to write

#2

Post by znpy » Mon, Oct 19, 2020, 12:25 AM UTC

Of you're writing non fiction, I recommend "On writing well". It's an acclaimed book on the subject.

It's been around for a while, you can get an used copy for a few bucks.

Re: Ask HN: Good resources on learning how to write

#3

Post by cac1 » Mon, Oct 19, 2020, 3:22 AM UTC

Epiphany WorkFlow for the Mac is about collecting ideas, organizing ideas, and referring to ideas while writing. It won't help you WRITE, but it will reduce the laborious overhead that gets in the way of writing.

Re: Ask HN: Good resources on learning how to write

#4

Post by st1x7 » Mon, Oct 19, 2020, 10:45 AM UTC

Google have a couple of good courses on technical writing - https://developers.google.com/tech-writing

Re: Ask HN: Good resources on learning how to write

#5

Post by caseyscottmckay » Mon, Oct 19, 2020, 7:43 PM UTC

The Elements of Style, Woe is I

Re: Ask HN: Good resources on learning how to write

#6

Post by maverickJ » Tue, Oct 20, 2020, 12:44 AM UTC

The following books below might be of help to you.

1. First You Write a Sentence by Joe Moran - https://amzn.to/3m2Hq8N

2. Reading Like a Writer by Francine Prose - https://amzn.to/3dEXY3M

3. On Writing: A Memoir of the Craft by Stephen King - https://amzn.to/3mfLFhF

In terms of technical content, there is a course for technical writers on pluralsight - https://www.pluralsight.com/courses/technical-writing-softwa...

Re: Ask HN: Good resources on learning how to write

#7

Post by [deleted] » Wed, Oct 28, 2020, 1:17 AM UTC

[deleted]

Re: Ask HN: Good resources on learning how to write

#8

Post by bayareamaverick » Wed, Oct 28, 2020, 1:21 AM UTC

For technical content writing, here's a collection of some good articles - https://weavrboards.com/devrel/board/developing-content-for-...

In general, for me a good approach has been with this '3S framework':

  1. Support - Write content that educates or supports in a timely fashion
  2. Sources - Parse through the discussions in domain specific sources (forums and communities) to get a pulse of what to write 
  3. Segmentation - Finalize on the stage of the user/developer journey (beginner, intermediate or an expert)