4 ms·

After reading the title, I was hoping that the article would be not about advertising, but about technical writing - whether in communication (email) or documen

by pferde 6y ago

After reading the title, I was hoping that the article would be not about advertising, but about technical writing - whether in communication (email) or documentation (internal or public). Good writing is paramount for both of these contexts. From good text formatting to realizing what the audience is and adjusting level of detail and pace accordingly.

VieEnCode 6y ago
Does HN have some resources to share on good technical writing?
- macintux 6y ago
  It’s come up a time or twenty. https://hn.algolia.com/?q=technical+writing https://hn.algolia.com/?q=technical+writing And while this is orthogonal, I’m sure there’s some overlap: this is a list of links I’ve compiled on giving technical talks. I haven’t checked the links for years, so I’m sure a few are broken. https://gist.github.com/macintux/5354837 https://gist.github.com/macintux/5354837
  - VieEnCode 6y ago
    Very helpful resources, thanks! I've bookmarked them to go through.
  - afarrell 6y ago
    > orthogonal I'd say it is no more than 20 degrees off.
- afarrell 6y ago
  After I read https://sites.duke.edu/niou/files/2014/07/WilliamsJosephM1990StyleTowardClarityandGrace.pdf https://sites.duke.edu/niou/files/2014/07/WilliamsJosephM199..., I found myself remembering its advice and putting it into practice.