Live data from Hacker News

Ask HN: Examples of good technical writing?

news.ycombinator.com

1–10 of 145 posts

Ask HN: Examples of good technical writing?

#1
I wonder if HN could share their favorite pieces of technical writing?

Preferably openly available content so that everyone can access (blogs etc.)

Focus is on "overall" score: tone, presentation, etc. as opposed to "very technically advanced" (although advanced examples fully welcome)

EDIT: awesome suggestions so far - should add that it doesn't have to be programming or even computer related... cookbooks count!

Re: Ask HN: Examples of good technical writing?

#5
https://www.prisma.io/dataguide/

Over the past few years, Prisma has been quietly building a complete zero to advanced guide to databases that I've started to refer people to and use as reference myself. It stands out to me because it is focusing on a broader topic than what you typically find in docs, it's written simply, it is super comprehensive, and it's not trying to sell something.

Re: Ask HN: Examples of good technical writing?

#8
Rustlings (https://github.com/rust-lang/rustlings) - interactivity

Inside look at modern web browser (https://developer.chrome.com/blog/inside-browser-part1/) - fun illustrations

Nunjucks (https://mozilla.github.io/nunjucks/templating.html) - easy-to-use site nav

Vodafone + Core Web Vitals case study (https://web.dev/vodafone/) - packed with info and no marketing BS (disclosure: I was majorly involved in that content)

Re: Ask HN: Examples of good technical writing?

#9
Here's an unusual suggestion...

In the 1980s the children's publisher Usborne published computing books for young readers and a few years ago they made the books available for free download. The books use illustrations extensively to explain concepts. Not only are these books well written with clear, concise explanations, they are also more readable and enjoyable than many programming and computing books published for adults today.

Anyone writing a technical guide (of any kind) would benefit from reading these as a source of ideas and inspiration:

https://usborne.com/gb/books/computer-and-coding-books

Post reply on HN