What makes a good technical book 'good'?
This question came up StackOverflow.
For me, the following ingredients make a good technical book great -
For me, the following ingredients make a good technical book great -
- Written mostly in plain-English
- No-fluff, straight-forward tone & a conversational style
- Author identifies the needs of audience in the beginning & meets the expectations set
- Has some kind of takeaways you can benefit from like crisp summaries, checklists, practical examples, re-usable code samples.
- Content is well-organized & structured.
- Attention is paid to technical accuracy, grammar, layout & fonts used
- Illustrations, backgrounders & infoboxes are provided where required & important information is highlighted.
- The author is an expert on the topic and isn't under the "curse of knowledge". A person contributing to the technical community (via online forums, meetups, source code donations, blog articles) would be more hands-on & therefore be a better teacher and author.
Comments
Post a Comment