Click here to Skip to main content
15,887,135 members

Welcome to the Lounge

   

For discussing anything related to a software developer's life but is not for programming questions. Got a programming question?

The Lounge is rated Safe For Work. If you're about to post something inappropriate for a shared office environment, then don't post it. No ads, no abuse, and no programming questions. Trolling, (political, climate, religious or whatever) will result in your account being removed.

 
GeneralRe: Your Most Absurd Pet Peeves Pin
fgs196323-Oct-23 10:47
fgs196323-Oct-23 10:47 
GeneralRe: Your Most Absurd Pet Peeves Pin
dandy7223-Oct-23 4:08
dandy7223-Oct-23 4:08 
GeneralRe: Your Most Absurd Pet Peeves Pin
Mircea Neacsu23-Oct-23 4:40
Mircea Neacsu23-Oct-23 4:40 
GeneralRe: Your Most Absurd Pet Peeves Pin
BernardIE531723-Oct-23 5:24
BernardIE531723-Oct-23 5:24 
GeneralRe: Your Most Absurd Pet Peeves Pin
kmoorevs23-Oct-23 5:26
kmoorevs23-Oct-23 5:26 
GeneralRe: Your Most Absurd Pet Peeves Pin
trønderen23-Oct-23 6:33
trønderen23-Oct-23 6:33 
GeneralRe: Your Most Absurd Pet Peeves Pin
jschell23-Oct-23 5:30
jschell23-Oct-23 5:30 
GeneralRe: Your Most Absurd Pet Peeves Pin
trønderen23-Oct-23 7:09
trønderen23-Oct-23 7:09 
Computer book authors, and their editors.

In the old days of typewriters, the authors were using words sparingly, writing what is necessary, and leaving the rest out. Today, books are so wordy, crammed with the author's personal opinions and excitement, repetitions upon repetitions, and a lot of stuff of minimal interest to the reader. I have several books where, every time I open them, I am itching to grab a black felt tip pen and strike out completely unnecessary sentences, and a plain pen to circle sentences and draw an error: This belongs in that paragraph (or chapter), not here.

There are the authors taking from granted that you are experienced in some other field, such as an earlier, now outdated / replaced technology, explaining the current technology mainly in terms of the old one.

Related: When you publish a revised 2023 edition of a book, you should also make sure to remove excited ovations about the new technology introduced in 2007. Make sure to update the references to specific versions of tools, libraries, standards etc. so that the discussions and examples are not outdated by several versions, and you have to go to an internet search to see what is still valid of that old stuff.

There are those authors who cannot limit themselves to the topic of the book, maybe because they have been lecturing to students who had not yet completed that other course. Like that book I bought to get to know the peculiarities of GPUs, and there is a lengthy chapter discussing the very basic concepts of binary semaphores.

Often, when a book treats a small handful of distinctly different technologies in separate chapters or sections, you cannot just read the introductory chapters and then skip to the section of the technology you want to learn: The examples, evaluations and explanations are built directly on top of the previous chapters; you must study them all to understand the explanations of 'your' technology. This if frequently the case even within one base technology: Examples are far from free standing; you must have studied them (and sometimes tried to solve the exercises) of all earlier chapters to understand the example to illustrate the solution to your problem.

Essentially, the books are like a professor's lecture notes: His students do not have a problem to solve, they have a set of topics that they are to learn, one after the other. They do work through the chapters and all the exercises, one by one. College textbooks are fine at a college, but if you publish for an audiences outside the college, but for a professional audience, you should do it differently, especially in the editing.
GeneralRe: Your Most Absurd Pet Peeves Pin
fgs196323-Oct-23 10:51
fgs196323-Oct-23 10:51 
GeneralRe: Your Most Absurd Pet Peeves Pin
Greg Utas23-Oct-23 14:31
professionalGreg Utas23-Oct-23 14:31 
GeneralRe: Your Most Absurd Pet Peeves Pin
Mycroft Holmes23-Oct-23 13:17
professionalMycroft Holmes23-Oct-23 13:17 
GeneralRe: Your Most Absurd Pet Peeves Pin
Greg Utas23-Oct-23 14:22
professionalGreg Utas23-Oct-23 14:22 
GeneralRe: Your Most Absurd Pet Peeves Pin
Paul Kemner26-Oct-23 4:39
Paul Kemner26-Oct-23 4:39 
GeneralRe: Your Most Absurd Pet Peeves Pin
Mike Winiberg23-Oct-23 21:39
professionalMike Winiberg23-Oct-23 21:39 
GeneralRe: Your Most Absurd Pet Peeves Pin
Paul Kemner26-Oct-23 4:02
Paul Kemner26-Oct-23 4:02 
GeneralRe: Your Most Absurd Pet Peeves Pin
Gustaf A23-Oct-23 22:08
Gustaf A23-Oct-23 22:08 
GeneralRe: Your Most Absurd Pet Peeves Pin
OriginalGriff23-Oct-23 22:12
mveOriginalGriff23-Oct-23 22:12 
GeneralRe: Your Most Absurd Pet Peeves Pin
trønderen23-Oct-23 23:34
trønderen23-Oct-23 23:34 
GeneralRe: Your Most Absurd Pet Peeves Pin
Alister Morton24-Oct-23 0:13
Alister Morton24-Oct-23 0:13 
GeneralRe: Your Most Absurd Pet Peeves Pin
trønderen24-Oct-23 1:50
trønderen24-Oct-23 1:50 
GeneralRe: Your Most Absurd Pet Peeves Pin
Alister Morton25-Oct-23 0:03
Alister Morton25-Oct-23 0:03 
GeneralRe: Your Most Absurd Pet Peeves Pin
OriginalGriff24-Oct-23 0:16
mveOriginalGriff24-Oct-23 0:16 
GeneralRe: Your Most Absurd Pet Peeves Pin
trønderen24-Oct-23 1:42
trønderen24-Oct-23 1:42 
GeneralRe: Your Most Absurd Pet Peeves Pin
Paul Kemner26-Oct-23 4:23
Paul Kemner26-Oct-23 4:23 
GeneralRe: Your Most Absurd Pet Peeves Pin
DanW5224-Oct-23 4:27
professionalDanW5224-Oct-23 4:27 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.