miekg / learninggo

Learning Go Book in mmark
https://miek.nl/go
Other
539 stars 111 forks source link

the wrong way to organise a book #61

Closed isomorphisms closed 4 years ago

isomorphisms commented 4 years ago

I’m making this comment too late, since the book seems to be done. This is the most common and worst way to organise a programming book. Nobody wants to read (yet another) chapter on arrays. Nobody’s end-goal is to create a type. Nobody who can already program wants to print hello world. Nobody wants to learn a language by reading the details of how assignment actually works.

It doesn’t matter how clear the writing of individual paragraphs is when it’s organised this way.