Live data from Hacker News

Ask HN: Examples of good technical writing?

news.ycombinator.com

61–70 of 145 posts

Re: Ask HN: Examples of good technical writing?

#62
"The 200 Class Seaplane Tender", by "Shaw" is a famous example of writing clarity. T. E. Lawrence ("Lawrence of Arabia") wrote this, while he was involved in testing a speedboat.

I can't find the text on line any more. Just ads for it as a collectable.

Re: Ask HN: Examples of good technical writing?

#63
post #10

Concrete Mathematics: A Foundation for Computer Science, by Ronald Graham, Donald Knuth, and Oren Patashnik, is the rare example of a textbook that is entirely useful, enlightening, and hilarious all at once.

I have two questions for people who worked through this book:

1. What was your mathematical knowledge when you read this book?

2. What did you gain from working through this book?

Re: Ask HN: Examples of good technical writing?

#65
post #30

Julia Evans' comics, zines and blog posts are absolutely brilliant. Accessible, educational and full of personality. https://jvns.ca/

Yes thank you

So many of these comments are recommending dry prose, Julia’s writing is fun and sympathetic about how hard all this junk is

I’ve found myself writing technical stuff in her voice a lot these days and I think it’s made my documentation more accessible

Re: Ask HN: Examples of good technical writing?

#66
I always loved the in-depth nature and clear writing style of the man page of the hwclock(8) program distributed with util-linux(-ng), and happily refer to it as an example of great documentation whenever I get a chance to: https://www.man7.org/linux/man-pages/man8/hwclock.8.html

Re: Ask HN: Examples of good technical writing?

#67
Anything by Rachel Carson.

Anything by Donald Knuth. He even teaches good writing in Mathematical Writing.

I always thought IBM held a high standard for their writing. So anything from the IBM System/370 Principles of Operation to their IBM Journal of Research and Development would be good.

Lately, I've been reading Algorithms by Dasgupta, et al and those boys can write.

Re: Ask HN: Examples of good technical writing?

#69
Code: The Hidden Language of Computer Hardware and Software by Charles Petzold is an excellent work that very clearly guides the reader through the components and steps that lead to the sophisticated computer systems we have nowadays. Each step is explained with no logical leaps and could be followed by a young child.

Improving almost anything by George Box blew my mind. As children and even as university students we have been lied to. We have been told that experiments must be carried out one at a time to assign effects. This is patently false. In fact, we miss out on potential interaction effects (think temperature and time in cooking) by using one factor at a time experimentation. In this book he discusses many now old but fundamental techniques by which large improvements in models can be gained with minimal data. It has helped me in my career immensely and made me aware of many usual methods and fields of study.

Post reply on HN