Re:How to self-publish a book: A handy list of resources
by pablo_c on Tuesday November 13, 2018 @09:17AM
(#18441063)
Hi! I wrote the post, glad you found useful!
Also, I'm with you with the recommendations :P It was just a funny image I found on the internet and shared to produce some laughs...
I use a lot of comparisons alongside the book, especially from the "technical to the real world".
Generalizations are also important, otherwise, it is impossible to get to the point. They shape ideas. cheers!
Re:How to self-publish a book: A handy list of resources
by innocentoldguy on Tuesday November 13, 2018 @02:43PM
(#18444189)
Excellent job! Thank you for your efforts in sharing the information.
For the most part, I think this article is full of excellent advice. I do disagree with three of the author's tips on how to write well though.
Specifically:
1. There is no need to avoid alliteration. You shouldn't drown your work in it, of course, but skillfully employing alliteration in your text can help your sentences flow and can make certain aspects of your content more memorable. I'd say it is better to learn to use alliteration, and use it to good effect, than to eschew it altogether.
2. Comparisons are not bad, especially in technical writing. When teaching, it is helpful to tie new concepts to existing knowledge and comparisons are one way to create these mental connections.
3. Generalizations aren't bad in technical writing either, especially in code samples. For example, telling a programmer how to print "Hello, World!" to the screen is a helpful generalization. With that knowledge, the developer can now use that same print statement for console output, messages, debugging, logging, and other tasks. Developers can take this deceptively simple generalization and use it for all kinds of specialized needs.
I think the key here is to learn to use alliteration, comparisons, and generalizations in a way that strengthens your writing, rather than detracting from it.